# 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*.
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*:
### Ambientes de desenvolvimento
Os ambientes de desenvolvimento contém variáveis que possuem valores distintos, dependendo do ambiente ativo:
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:
### 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.
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.
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:
{% endhint %}
{% file src="/files/-M03o9cE5QB3vLoPUlzJ" %}
Para importar e usar no Postman
{% endfile %}
---
# Agent Instructions: 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:
```
GET https://docs.autentique.com.br/api/2/integracao/altair.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.