> 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
