{"meta":{"title":"À propos de l’API GraphQL","intro":"L’API GitHub GraphQL offre une flexibilité et la possibilité de définir précisément les données que vous souhaitez extraire.","product":"GraphQL API","breadcrumbs":[{"href":"/fr/graphql","title":"GraphQL API"},{"href":"/fr/graphql/overview","title":"Vue d’ensemble"},{"href":"/fr/graphql/overview/about-the-graphql-api","title":"À propos de l’API GraphQL"}],"documentType":"article"},"body":"# À propos de l’API GraphQL\n\nL’API GitHub GraphQL offre une flexibilité et la possibilité de définir précisément les données que vous souhaitez extraire.\n\n## Vue d’ensemble\n\nVoici quelques liens rapides pour vous aider à devenir opérationnel avec l’API GraphQL :\n\n* [Authentication](/fr/graphql/guides/forming-calls-with-graphql#authenticating-with-graphql)\n* [Point de terminaison racine](/fr/graphql/guides/forming-calls-with-graphql#the-graphql-endpoint)\n* [Introspection de schéma](/fr/graphql/guides/introduction-to-graphql#discovering-the-graphql-api)\n* [Limites du taux de transfert](/fr/graphql/overview/rate-limits-and-query-limits-for-the-graphql-api)\n* [Migrer depuis REST](/fr/graphql/guides/migrating-from-rest-to-graphql)\n\nPour plus d’informations sur GitHubles API, consultez [Comparaison de l'API REST de GitHub et de l'API GraphQL](/fr/rest/about-the-rest-api/comparing-githubs-rest-api-and-graphql-api).\n\n## À propos de GraphQL\n\nLe langage de requête de données [GraphQL](https://graphql.org/) est :\n\n* **Une [spécification](https://spec.graphql.org/June2018/).** La spécification détermine la validité du [schema](/fr/graphql/guides/introduction-to-graphql#schema) sur le serveur d’API. Le schéma détermine la validité des appels clients.\n\n* **[Fortement typé](#about-the-graphql-schema-reference).** Le schéma définit le système de type et toutes les relations d’objet d’une API.\n\n* **[Introspective](/fr/graphql/guides/introduction-to-graphql#discovering-the-graphql-api).** Un client peut interroger le schéma afin d’obtenir des détails sur celui-ci.\n\n* **[Hiérarchique](/fr/graphql/guides/forming-calls-with-graphql).** La forme d’un appel GraphQL reflète celle des données JSON qu’il retourne.               Des [champs imbriqués](/fr/graphql/guides/migrating-from-rest-to-graphql#example-nesting) vous permettent d'interroger et recevoir uniquement les données que vous spécifiez en un seul aller-retour.\n\n* **Une couche d'application** GraphQL n’est pas un modèle storage ni un langage de requête de base de données. Le *graph* fait référence aux structures de graphe définies dans le schéma, où [nodes](/fr/graphql/guides/introduction-to-graphql#node) définir des objets et des [edges](/fr/graphql/guides/introduction-to-graphql#edge) définir des relations entre les objets. L’API traverse et retourne des données d’application en fonction des définitions du schéma, indépendamment de la façon dont les données sont stockées.\n\n## Pourquoi GitHub utilise GraphQL\n\nGitHub choisi GraphQL, car il offre beaucoup plus de flexibilité pour nos intégrateurs. La possibilité de définir précisément les données que vous souhaitez —et *uniquement*  celles-ci— offre un avantage puissant par rapport aux points de terminaison d’API REST traditionnels. GraphQL vous permet de remplacer plusieurs requêtes REST par *un seul appel* pour extraire les données que vous spécifiez.\n\nPour plus d’informations sur la raison pour laquelle GitHub investi dans GraphQL, consultez le billet de blog [announcement d’origine](https://github.blog/2016-09-14-the-github-graphql-api/).\n\n## À propos de la référence du schéma GraphQL\n\nLes documents de la barre latérale sont générés à partir du GitHub[schéma](/fr/graphql/guides/introduction-to-graphql#discovering-the-graphql-api) GraphQL. Tous les appels sont validés et exécutés par rapport au schéma. Utilisez ces documents pour découvrir les données que vous pouvez appeler :\n\n* Opérations autorisées : requêtes et mutations.\n\n* Types définis par le schéma : scalaires, objets, énumérations, interfaces, unions et objets d’entrée.\n\nPour d’autres informations, telles que les détails de la limite d’authentification et de débit, consultez la [guides](/fr/graphql/guides).\n\n## Demande de support\n\nPour consulter les questions, les rapports de bogues et les discussions concernant GitHub Apps, OAuth apps et le développement d’API, explorez les [Catégorie API et Webhooks dans les discussions de la communauté GitHub](https://github.com/orgs/community/discussions/categories/api-and-webhooks). Les discussions sont animées et gérées par le personnel GitHub et répondues par la communauté GitHub.\n\nEnvisagez de contacter le [Support GitHub](https://support.github.com/) directement à l’aide du formulaire de contact pour :\n\n* Réponse garantie du personnel de GitHub\n* Les demandes de support impliquant des données sensibles ou des préoccupations d’ordre privé\n* Demandes de fonctionnalités\n* Commentaires sur les produits GitHub\n\nSi vous observez des défaillances inattendues, vous pouvez utiliser [githubstatus.com](https://www.githubstatus.com/) ou [l’APIGitHub d’état](https://www.githubstatus.com/api) pour rechercher les incidents affectant l’API."}