Informationen zu OpenAPI
Bei OpenAPI handelt es sich um eine Spezifikation zum Beschreiben von REST-API-Schnittstellen. Sie beschreibt die API, ohne dass Zugriff auf den Quellcode oder zusätzliche Dokumentation erforderlich ist. Die Spezifikation ist sowohl menschlich als auch maschinenlesbar. Weitere Informationen findest du in der OpenAPI-Dokumentation sowie im jeweiligen SDK:
Informationen zur OpenAPI-Beschreibung von GitHub
Die GitHub-OpenAPI-Beschreibung der REST-API ist öffentlich verfügbar. Du findest die Beschreibung im Open Source-Repository github/rest-api-description
GitHub stellt sowohl 3.0- als auch 3.1 OpenAPI-Beschreibungen bereit.
Für jede Beschreibung gibt es eine Version für jedes Produkt: GitHub Free/GitHub Pro/GitHub Team (api.github.com), GitHub Enterprise Cloud (ghec) und jede Version von GitHub Enterprise Server (ghes-X.X).
Wenn die datumsbasierte Versionsverwaltung für jedes Produkt unterstützt wird, gibt es auch eine Beschreibung für jede datumsbasierte Version. Weitere Informationen findest du unter API-Versionen.
Jede Beschreibung ist in einem gebündelten oder abgeleiteten Format verfügbar. Das gebündelte Format verwendet $ref, um auf OpenAPI-Komponenten zu verweisen, die zwischen Endpunkten gemeinsam verwendet werden. Das abgeleitete Format enthält die vollständig erweiterte Beschreibung.
Verwenden der GitHub OpenAPI-Beschreibung
Da die OpenAPI-Beschreibung maschinenlesbar ist, kannst du sie verwenden, um Aufgaben zu erledigen wie:
- Generieren von Bibliotheken zur Erleichterung der Verwendung der REST-API
- Überprüfen und Testen einer Integration, die die REST-API verwendet
- Erkunde und interagiere mit der REST-API mithilfe von Tools von Drittanbietern, z. B. Insomnia oder Postman.
Beispielsweise verwendet GitHub die OpenAPI-Beschreibung, um die Octokit-SDKs zu generieren. GitHub verwendet auch die OpenAPI-Beschreibung, um die REST-API-Referenzdokumentation für jeden Endpunkt zu generieren.