> For the complete documentation index, see [llms.txt](https://docs.autentique.com.br/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autentique.com.br/api/2/integracao/altair.md).

# Usando o Altair

O passo mais importante para usar o Altair é acessar esse link: [https://altair.autentique.com.br](https://altair.autentique.com.br/) (Nós fizemos algumas pequenas mudanças no *client* padrão do Altair pra facilitar a sua vida, como collections personalizadas com as principais ações do Autentique)

### Headers das requisições

Ao abrir o [link](https://altair.autentique.com.br), a primeira tela que você verá será a de *Headers*. 

![](/files/-LuYJVKS-UHrZMwRtYhb)

Como você já deve ter imaginado, são esses os headers que você precisa passar ao fazer uma requisição para a API, e que aquele **SUA\_CHAVE\_DE\_API** deve ser substituído pela sua [chave de API](https://painel.autentique.com.br/perfil/api) (sim, já aconteceu).

{% hint style="info" %}
Não remova o trecho "Bearer" na frente da chave de API, substitua apenas o que vem depois dele
{% endhint %}

Caso você queira alterar sua chave, você poderá acessar essa tela novamente em *Set Headers*:

![](/files/-LscgFjFwbQAq3vsku4U)

### Ambientes de desenvolvimento

Os ambientes de desenvolvimento contém variáveis que possuem valores distintos, dependendo do ambiente ativo:

![](/files/-LzJ4QUKeKOGYS16ABJd)

Há duas coisas interessantes nessa imagem. A primeira é o **{{endpointURL}}** que é a variável definida na segunda coisa interessante, que é o ambiente de desenvolvimento *Production*, ali no canto superior direito.

No mesmo menu há a opção "*Environments...*" que possui a definição dessas variáveis:

![](/files/-LzJ5Ks8I1z5xJmpOt2c)

### Coleções

Nós criamos algumas *collections* com as principais ações/queries utilizadas no Autentique. Você pode conferir/testar/utilizar elas em seu projeto ou como referência para criar as suas próprias queries.

![](/files/-Lsx1JkixaCe6gmH-pOx)

As *collections* são só exemplos, portanto não são uma representação de tudo o quê você pode fazer com a API. E tem algumas que você precisa completar alguns parâmetros para funcionar, como IDs do documento, pastas etc.

{% hint style="warning" %}
As *collections* podem não estar funcionando no Firefox com o modo privado ativo.
{% endhint %}

### Documentação

Além das *collections*, há uma documentação nativa **muito mais completa** que contém tudo que você pode fazer com a API.

Ao clicar em **Docs**, no topo da tela, será exibida uma barra lateral contendo a documentação. Caso esteja vazio para você, clique em **Reload Docs** para recarregar a documentação ou, se mesmo assim não estiver aparecendo nada, confira nos Headers se você colocou a chave de API e tente novamente.

![](/files/-LscgRAenAmKYK6zhrIe)

Os primeiros itens são **Query** (funções para apenas buscar informações) e **Mutation** (funções que executam algum tipo de ação ou mudança). Ao clicar em alguma delas será exibido o que você pode fazer com a API no momento, contendo todas as funções que podem ser enviadas e informações consultáveis.

Nos próximos passos, vamos mostrar algumas dessas *queries*/*mutations* e como executá-las no Altair.

{% hint style="info" %}
Sim, o nome Altair é uma referência a Assassin's Creed e isso talvez tenha sido considerado quando escolhemos ele
{% endhint %}

{% hint style="info" %}
Se o Altair não te ajuda para integrar com a API, confira alguns exemplos de como fazer essas requisições de outra forma: <https://graphql.org/graphql-js/graphql-clients/>
{% endhint %}

{% file src="/files/-M03o9cE5QB3vLoPUlzJ" %}
Para importar e usar no Postman
{% endfile %}