Visão geral
Aqui estão alguns links rápidos para ajudar você a colocar em funcionamento a API do GraphQL:
Para saber mais sobre as APIs do GitHub, confira "Comparando a API REST do GitHub e a API GraphQL".
Sobre o GraphQL
A linguagem de consulta de dados GraphQL é:
-
Uma especificação. A especificação determina a validade do esquema no servidor de API. O esquema determina a validade das chamadas dos clientes.
-
Fortemente tipada. O esquema define o sistema de tipos e todas as relações de objeto de uma API.
-
Introspectiva. Um cliente pode consultar o esquema para ver detalhes sobre o esquema.
-
Hierárquica. A forma de uma chamada do GraphQL espelha a forma dos dados JSON retornados. Os campos aninhados permitem consultar e receber apenas os dados especificados em uma só ida e volta.
-
Uma camada de aplicativo. O GraphQL não é um modelo de armazenamento nem uma linguagem de consulta de banco de dados. O grafo refere-se a estruturas de grafo definidas no esquema, em que nós definem os objetos e bordas definem as 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.
Por que o GitHub está usando GraphQL
O GitHub escolheu o GraphQL, porque oferece muito mais flexibilidade para os nossos integradores. A capacidade de definir com precisão os dados desejados (e apenas os dados desejados) são uma excelente 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.
Para obter mais detalhes sobre por que o GitHub investiu no GraphQL, confira a postagem no blog do comunicado original.
Sobre a referência do esquema do GraphQL
A documentação na barra lateral é gerada com base no esquema do GraphQL do GitHub. Todas as chamadas são validadas e executadas contra o esquema. Use estes documentos para descobrir quais dados você pode chamar:
-
Tipos definidos por esquema: escalares, objetos, enumerações, interfaces, uniões e objetos de entrada.
Acesse esse mesmo conteúdo por meio da barra lateral do Explorer Docs. Observe que você pode precisar confiar tanto na documentação quanto na validação do esquema para chamar com sucesso a API do GraphQL.
Para obter outras informações, como detalhes de autenticação e limite de taxa, confira os guias.
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. As discussões são moderadas e mantidas pela equipe do GitHub, mas não é garantido que as perguntas publicadas no fórum recebam uma resposta da equipe do GitHub.
Considere a possibilidade de entrar em contato diretamente com o Suporte do GitHub usando o formulário de contato para:
- resposta garantida dos funcionários de GitHub Enterprise Server
- solicitações de suporte que envolvem dados confidenciais ou questões privadas
- solicitações de recursos
- feedback sobre produtos de GitHub Enterprise Server