> 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 Altair é uma aplicação para executar queries/mutations em GraphQL. Nele você poderá construir e conferir o resultado das requisições na web, antes de colocar em seu código. 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*. ![](https://469185076-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXffZ8FZep2ukRK-gJz%2F-LuYJFiKnss0tGlaHylu%2F-LuYJVKS-UHrZMwRtYhb%2Fimage.png?alt=media\&token=02035700-a7e1-4075-a06e-2aa3141f35a3) 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*: ![](https://469185076-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXffZ8FZep2ukRK-gJz%2F-LscfnJuqta0N3q0ucb-%2F-LscgFjFwbQAq3vsku4U%2Fscreely-1572640718076.png?alt=media\&token=7d2c6c3b-3ac7-4900-a13e-cb64bc356df5) ### Ambientes de desenvolvimento Os ambientes de desenvolvimento contém variáveis que possuem valores distintos, dependendo do ambiente ativo: ![](https://469185076-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXffZ8FZep2ukRK-gJz%2F-LzJ1QTsEz95AZDA4NpK%2F-LzJ4QUKeKOGYS16ABJd%2Fimage.png?alt=media\&token=4b47acd5-58aa-4284-8654-f2b4fdb96ac7) 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: ![](https://469185076-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXffZ8FZep2ukRK-gJz%2F-LzJ1QTsEz95AZDA4NpK%2F-LzJ5Ks8I1z5xJmpOt2c%2Fimage.png?alt=media\&token=50d643dc-d136-44d7-88e0-f8ba23f5341c) ### 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. ![](https://469185076-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXffZ8FZep2ukRK-gJz%2F-Lsx1F35BeUObhwHR3q7%2F-Lsx1JkixaCe6gmH-pOx%2Fimage.png?alt=media\&token=416230bf-4760-47da-a30c-9a84f20ac356) 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. ![](https://469185076-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LXffZ8FZep2ukRK-gJz%2F-LscfnJuqta0N3q0ucb-%2F-LscgRAenAmKYK6zhrIe%2Fscreely-1572640764615.png?alt=media\&token=88e270b2-d4f4-4fd3-9748-a071f6ea2edb) 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 %}