> For the complete documentation index, see [llms.txt](https://docs.skyone.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skyone.cloud/api-skyone-autosky/introducao.md).

# Introdução

Esta documentação apresenta as informações necessárias para integração de sistemas e plataformas com a **API Skyone Autosky**.

Através desta API, será possível realizar procedimentos para integração com os seguintes objetos:

* **Clientes (Grupos de Usuários)**
* **Usuários**
* **Aplicações**
* **Sessões de Usuários**
* **Autenticação de Usuário**
* **Logon de Usuários**

## Versão

V2.3 - (19/07/2024)

## Pré-Requisitos

Para a utilização das APIs, será necessário ter acesso às informações de autenticação que serão enviadas pela equipe de integrações da Skyone.

Por exemplo:

| Item                  | Exemplo                                |
| --------------------- | -------------------------------------- |
| Token de Autenticação | `23a1e4e6f90546e498a8f66cf21e3fb3`     |
| UUID Ambiente         | `6a6c7a07-bef1-4e42-942e-87277a8c2a84` |
| URL de Homologação    | `piloto.skyinone.net`                  |
| URL de Produção       | `meudominio.skyinone.net`              |

## Base URL

```
https://meudominio.skyinone.net/v2/api/
```

### Autenticação Chamada API

Ao obter seu token de autenticação para as chamadas de API da plataforma Autosky, esse token deverá ser utilizado em todas as chamadas de API.

Existem duas formas de utilização do Token de autenticação:

#### Token via URL

Nesta modalidade o token deve ser enviado como argumento nas chamadas da API, como por exemplo:

[`http://meudominio.skyinone.net/v2/api/clients/`](http://meudominio.skyinone.net/v2/api/clients/)**`?token=xxxxx`**

#### Token via Header

Na modalidade de envio do token via header deve ser passado como cabeçalho nas chamadas da API. O cabeçalho deve seguir o seguinte modelo:

* **Authorization:xxxxxx**

Neste exemplo utilizando o HTTPie: http <http://meudominio.skyinone.net/v2/api/clients/> **Authorization:xxxx**


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.skyone.cloud/api-skyone-autosky/introducao.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.