{"meta":{"title":"Como usar clientes do GraphQL","intro":"Você pode executar consultas em dados reais do GitHub usando vários clientes e bibliotecas do GraphQL.","product":"API GraphQL","breadcrumbs":[{"href":"/pt/graphql","title":"API GraphQL"},{"href":"/pt/graphql/guides","title":"Guias"},{"href":"/pt/graphql/guides/using-graphql-clients","title":"Como usar clientes do GraphQL"}],"documentType":"article"},"body":"# Como usar clientes do GraphQL\n\nVocê pode executar consultas em dados reais do GitHub usando vários clientes e bibliotecas do GraphQL.\n\n> \\[!WARNING]\n> 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).\n\n## Como usar IDEs de cliente do GraphQL\n\nHá muitos IDEs de cliente do GraphQL de código aberto que você pode usar para acessar a API do GraphQL do GitHub.\n\nConsulte [Realizar chamadas com o GraphQL](/pt/graphql/guides/forming-calls-with-graphql) para obter informações abrangentes sobre métodos HTTP, autenticação e estrutura de chamadas graphQL.\n\nPrimeiro, 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).\n\nAs instruções gerais a seguir funcionarão com a maioria dos clientes do GraphQL:\n\n1. Aponte o cliente para o ponto de extremidade do GraphQL: `https://api.github.com/graphql`.\n\n2. 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/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)).\n\n3. Defina o método de solicitação `POST` como ou se ele estiver disponível, use o modo GraphQL fornecido pelo cliente.\n\n4. Insira sua consulta ou mutação no editor e, se necessário, forneça variáveis no painel \"Variáveis\".\n\n   Exemplo:\n\n   ```graphql\n   query {\n     viewer {\n       login\n     }\n   }\n   ```\n\n5. 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\".\n\n   Consulta de introspecção mínima:\n\n   ```graphql\n   query IntrospectionQuery {\n     __schema {\n       types {\n         name\n       }\n     }\n   }\n   ```\n\n6. 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.\n\nUse a interface do usuário do cliente para explorar documentos, executar consultas e salvar solicitações conforme necessário.\n\n## GitHub CLI\n\nVocê também pode usar a linha de comando com a GitHub CLI para executar consultas do GraphQL.\n\n1. Instale e [autentique na GitHub CLI](https://cli.github.com/manual/gh_auth_login).\n2. Execute uma consulta em `https://api.github.com/graphql` usando o endpoint GraphQL com o subcomando [`gh api`](https://cli.github.com/manual/gh_api).\n\nExemplo:\n\n```shell\ngh api graphql -f query='query { viewer { login } }'\n```\n\nEla deve retornar o logon associado ao GitHub do personal access token com os quais você se autenticou.\n\n## Solicitar suporte\n\nEm 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.\n\nConsidere a possibilidade de entrar em contato diretamente com o [Suporte do GitHub](https://support.github.com/) usando o formulário de contato para:\n\n* Resposta garantida da equipe do GitHub\n* Solicitações de suporte que envolvem dados confidenciais ou questões privadas\n* Solicitações de recursos\n* Comentários sobre os produtos do GitHub"}