{"meta":{"title":"À propos de la description OpenAPI pour l'API REST","intro":"L’API GitHub REST est entièrement décrite dans un document conforme OpenAPI.","product":"API REST","breadcrumbs":[{"href":"/fr/rest","title":"API REST"},{"href":"/fr/rest/about-the-rest-api","title":"Informations sur l’API REST"},{"href":"/fr/rest/about-the-rest-api/about-the-openapi-description-for-the-rest-api","title":"Description d'OpenAPI"}],"documentType":"article"},"body":"# À propos de la description OpenAPI pour l'API REST\n\nL’API GitHub REST est entièrement décrite dans un document conforme OpenAPI.\n\n## À propos d'OpenAPI\n\nOpenAPI est une spécification pour décrire les interface API REST. Il décrit l'API sans avoir besoin d'accéder au code source ou à une documentation supplémentaire. La spécification est à la fois humaine et lisible par l'ordinateur. Pour plus d'informations, consultez la [documentation OpenAPI spécifique](https://spec.openapis.org/oas/v3.1.0).\n\n## À propos de la description OpenAPI de GitHub\n\nGitHubLa description OpenAPI de l’API REST est disponible publiquement. Vous trouverez la description dans le référentiel open source [github/rest-api-description](https://github.com/github/rest-api-description).\n\nGitHub fournit les descriptions OpenAPI 3.0 et 3.1.\n\nPour chaque description, il existe une version pour chaque produit : GitHub Free/GitHub Pro/GitHub Team(), `api.github.com` (GitHub Enterprise Cloud`ghec`) et chaque version de GitHub Enterprise Server ().`ghes-X.X`\n\nPour chaque produit, si le contrôle de version basé sur des dates est pris en charge, il existe également une description pour chaque version basée sur des dates. Pour plus d’informations, consultez « [Versions des API](/fr/rest/about-the-rest-api/api-versions) ».\n\nChaque description est disponible dans un format groupé ou dans un format déréférencé. Le format groupé utilise `$ref` pour faire référence aux composants OpenAPI partagés entre les points de terminaison. Le format de déréférencement inclut la description complètement développée.\n\n## Utilisation de la description OpenAPI GitHub\n\nÉtant donné que la description OpenAPI est lisible par l'ordinateur, vous pouvez l'utiliser pour effectuer des opérations telles que :\n\n* Générer des bibliothèques pour faciliter l'utilisation de l'API REST\n* Valider et tester une intégration qui utilise l'API REST\n* Explorer et interagir avec l'API REST à l'aide d'outils tiers, comme Insomnia ou Postman\n\nPar exemple, GitHub utilise la description OpenAPI pour générer les kits sdk Octokit.\nGitHub utilise également la description OpenAPI pour générer la documentation de référence de l’API REST pour chaque point de terminaison."}