{"meta":{"title":"Sobre a API do GraphQL","intro":"A GitHub API do GraphQL oferece flexibilidade e a capacidade de definir precisamente os dados que você deseja buscar.","product":"API GraphQL","breadcrumbs":[{"href":"/pt/graphql","title":"API GraphQL"},{"href":"/pt/graphql/overview","title":"Visão geral"},{"href":"/pt/graphql/overview/about-the-graphql-api","title":"Sobre a API do GraphQL"}],"documentType":"article"},"body":"# Sobre a API do GraphQL\n\nA GitHub API do GraphQL oferece flexibilidade e a capacidade de definir precisamente os dados que você deseja buscar.\n\n## Visão geral\n\nAqui estão alguns links rápidos para ajudar você a colocar em funcionamento a API do GraphQL:\n\n* [Authentication](/pt/graphql/guides/forming-calls-with-graphql#authenticating-with-graphql)\n* [Ponto de extremidade raiz](/pt/graphql/guides/forming-calls-with-graphql#the-graphql-endpoint)\n* [Introspecção de esquema](/pt/graphql/guides/introduction-to-graphql#discovering-the-graphql-api)\n* [Limites de taxa](/pt/graphql/overview/rate-limits-and-query-limits-for-the-graphql-api)\n* [Migrando de REST](/pt/graphql/guides/migrating-from-rest-to-graphql)\n\nPara obter mais informações sobre as APIs de GitHub, consulte [Comparando a API REST do GitHub e a API do GraphQL](/pt/rest/about-the-rest-api/comparing-githubs-rest-api-and-graphql-api).\n\n## Sobre o GraphQL\n\nA linguagem de consulta de dados [GraphQL](https://graphql.org/) é:\n\n* **Uma [especificação](https://spec.graphql.org/June2018/).** A especificação determina a validade do [schema](/pt/graphql/guides/introduction-to-graphql#schema) no servidor de API. O esquema determina a validade das chamadas dos clientes.\n\n* **[Fortemente tipada](#about-the-graphql-schema-reference).** O esquema define o sistema de tipos e todas as relações de objeto de uma API.\n\n* **[Introspective](/pt/graphql/guides/introduction-to-graphql#discovering-the-graphql-api).** Um cliente pode consultar o esquema para ver detalhes sobre o esquema.\n\n* **[Hierárquico](/pt/graphql/guides/forming-calls-with-graphql).** A forma de uma chamada do GraphQL espelha a forma dos dados JSON retornados. [Campos aninhados](/pt/graphql/guides/migrating-from-rest-to-graphql#example-nesting) permite que você pesquise e receba apenas os dados especificados em um único ciclo.\n\n* **Uma camada de aplicativo.** O GraphQL não é um modelo storage ou uma linguagem de consulta de banco de dados. O *graph* refere-se a estruturas de grafo definidas no esquema, em que [nodes](/pt/graphql/guides/introduction-to-graphql#node) definem objetos e [edges](/pt/graphql/guides/introduction-to-graphql#edge) definem relações entre objetos. A API percorre e retorna dados do aplicativo com base nas definições do esquema, independentemente de como os dados são armazenados.\n\n## Por que GitHub está usando o GraphQL\n\nGitHub escolheu o GraphQL porque oferece significativamente mais flexibilidade para nossos integradores. A capacidade de definir com precisão os dados que você deseja e apenas os dados que você deseja é uma poderosa vantagem em relação aos pontos de extremidade tradicionais da API REST. O GraphQL permite que você substitua várias solicitações da REST por *uma só chamada* para buscar os dados especificados.\n\nPara obter mais detalhes sobre por que GitHub investido no GraphQL, consulte a postagem original do blog [announcement](https://github.blog/2016-09-14-the-github-graphql-api/).\n\n## Sobre a referência do esquema do GraphQL\n\nOs documentos na barra lateral são gerados a partir do GitHub[esquema](/pt/graphql/guides/introduction-to-graphql#discovering-the-graphql-api) GraphQL. Todas as chamadas são validadas e executadas contra o esquema. Use estes documentos para descobrir quais dados você pode chamar:\n\n* Operações permitidas: consultas e mutações.\n\n* Tipos definidos por esquema: escalares, objetos, enumerações, interfaces, uniões e objetos de entrada.\n\nPara obter outras informações, como detalhes de autenticação e limite de taxa, confira o [guides](/pt/graphql/guides).\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\n\nSe você observar falhas inesperadas, poderá usar [githubstatus.com](https://www.githubstatus.com/) ou a [GitHub API de status](https://www.githubstatus.com/api) para verificar se há incidentes que afetam a API."}