# Como usar clientes do GraphQL

Você pode executar consultas em dados reais do GitHub usando vários clientes e bibliotecas do GraphQL.

> \[!WARNING]
> O Explorador do GraphQL foi removido da documentação em 11 de novembro de 2025. Consulte nosso [comunicado do log de alterações](https://github.blog/changelog/2025-11-07-graphql-explorer-removal-from-api-documentation-on-november-7-2025).

## Como usar IDEs de cliente do GraphQL

Há muitos IDEs de cliente do GraphQL de código aberto que você pode usar para acessar a API do GraphQL do GitHub.

Consulte [Realizar chamadas com o GraphQL](/pt/enterprise-server@3.22/graphql/guides/forming-calls-with-graphql) para obter informações abrangentes sobre métodos HTTP, autenticação e estrutura de chamadas graphQL.

Primeiro, escolha um cliente. As opções comuns incluem GraphiQL, Insomnia e Altair (desktop/web/extensão). Você pode ver a lista completa de clientes no [diretório de ferramentas da organização do GraphQL](https://graphql.org/community/tools-and-libraries/?tags=services).

As instruções gerais a seguir funcionarão com a maioria dos clientes do GraphQL:

1. Aponte o cliente para o ponto de extremidade do GraphQL: `http(s)://HOSTNAME/api/graphql`.

2. Adicione um cabeçalho `Authorization`: `Authorization: Bearer TOKEN` (substitua `TOKEN` pelo arquivo GitHub do personal access token. Para obter mais informações, consulte [Gerenciar seus tokens de acesso pessoal](/pt/enterprise-server@3.22/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)).

3. Defina o método de solicitação `POST` como ou se ele estiver disponível, use o modo GraphQL fornecido pelo cliente.

4. Insira sua consulta ou mutação no editor e, se necessário, forneça variáveis no painel "Variáveis".

   Exemplo:

   ```graphql
   query {
     viewer {
       login
     }
   }
   ```

5. Se o cliente precisar de um esquema para renderização de documentação ou preenchimento automático, busque-o por meio de uma consulta de introspecção do GraphQL. Muitos clientes podem fazer isso automaticamente no painel "Documentação".

   Consulta de introspecção mínima:

   ```graphql
   query IntrospectionQuery {
     __schema {
       types {
         name
       }
     }
   }
   ```

6. Execute a solicitação e inspecione a resposta JSON. A consulta do exemplo deve retornar o logon associado ao GitHub do personal access token com os quais você se autenticou.

Use a interface do usuário do cliente para explorar documentos, executar consultas e salvar solicitações conforme necessário.

## GitHub CLI

Você também pode usar a linha de comando com a GitHub CLI para executar consultas do GraphQL.

1. Instale e [autentique na GitHub CLI](https://cli.github.com/manual/gh_auth_login).
2. Execute uma consulta em `http(s)://HOSTNAME/api/graphql` usando o endpoint GraphQL com o subcomando [`gh api`](https://cli.github.com/manual/gh_api).

Exemplo:

```shell
gh api graphql -f query='query { viewer { login } }'
```

Ela deve retornar o logon associado ao GitHub do personal access token com os quais você se autenticou.

## Solicitar suporte

Em caso de dúvidas, relatórios de bug e discussões sobre o GitHub Apps, o OAuth apps e o desenvolvimento de API, explore o [Categoria de API e Webhooks nas Discussões da Comunidade do GitHub](https://github.com/orgs/community/discussions/categories/api-and-webhooks). As discussões são moderadas e mantidas pela equipe GitHub e respondidas pela comunidade GitHub.

Considere a possibilidade de entrar em contato diretamente com o [Suporte do GitHub](https://support.github.com/) usando o formulário de contato para:

* Resposta garantida da equipe do GitHub
* Solicitações de suporte que envolvem dados confidenciais ou questões privadas
* Solicitações de recursos
* Comentários sobre os produtos do GitHub