Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Description d’OpenAPI

L’API REST GitHub Enterprise Serverest entièrement décrite dans un document conforme à OpenAPI 3.0.

À propos des descriptions d’OpenAPI

OpenAPI est une spécification standard pour décrire les API REST. Les descriptions OpenAPI permettent aux humains et aux machines de découvrir les fonctionnalités d’une API sans avoir à lire d’abord la documentation ou à comprendre l’implémentation. GitHub a rendu son API REST publiquement disponible en tant que document conforme OpenAPI 3.0.

Obtention de la description OpenAPI GitHub

Vous trouverez la description dans le dépôt open source REST API OpenAPI Description.

Nous fournissons la description dans deux formats. La version en bundle fonctionne dans la plupart des situations, car elle inclut des composants OpenAPI pour la réutilisation et la lisibilité. Si votre outil ne prend pas en charge les références inline aux composants, nous fournissons également une version entièrement déréférencée.

Utilisation de la description OpenAPI GitHub

Une description OpenAPI peut être utilisée de nombreuses façons. Par exemple, vous pouvez :

  • Générer votre propre client d’API.
  • Valider et tester une intégration d’API REST GitHub.
  • Explorer et interagir avec l’API REST GitHub Enterprise Server à l’aide d’outils tiers, comme Insomnia ou Postman.

Par exemple, GitHub utilise la description OpenAPI REST pour générer la documentation de référence de l’API REST GitHub Enterprise Server.