Anzeige
Anzeige
News
Artikel merken

GitHubs Rest-API wird zugänglicher: Open-API-Description ist jetzt Open Source

Die GitHub-Rest-API ist so etwas wie eine Industriereferenz für eine durchdacht designte API. Künftig wird die Interaktion mit dem Interface noch einfacher: Das Unternehmen hat jetzt eine Open-API-Description der eigenen Rest-API unter einer Open-Source-Lizenz veröffentlicht.

2 Min. Lesezeit
Anzeige
Anzeige

Bild: Casimiro PT/Shutterstock

Das Rest-API der Versionierungsplattform gibt es schon seit 2008, erstmalig veröffentlicht wurde das Application-Programming-Interface nur einen Monat nach dem Launch von github.com. Unter Entwicklern gilt sie als ein Musterbeispiel für gutes API-Design. Aus diesem Grund hat die Plattform eine Open-AI-Beschreibung der API jetzt – zwölf Jahre und drei Major-Revisionen später – unter einer Open-Source-Lizenz veröffentlicht.

Die Open-API-Spezifikation

Anzeige
Anzeige

Die Open-API-Spezifikation ist ein Programmiersprachen-agnostischer Standard zur Beschreibung von http-API, über den sowohl Menschen als auch Maschinen die Möglichkeiten einer API erkunden können, ohne zuerst die Doku lesen oder die Implementation nachvollziehen zu müssen. Die Spezifikation gilt als Industriestandard.

Das ist drin

GitHubs Open-API-Description enthält Beschreibungen von über 600 Vorgängen der hauseigenen Rest-API. Wer die API visuell erkunden möchte, kann sich den Spaß in Form einer Postman-Collection downloaden. Programmatisch könnt ihr die Description nutzen, um Mock-Server, Test-Umgebungen und Bindings für Sprachen zu generieren, die nicht von den offiziellen GitHub-API-Clients unterstützt werden.

Anzeige
Anzeige

Die Description gibt es in zwei Formaten. Mit der gebündelten Version stehen euch verschiedene, wiederverwendbare Objekte zur Verfügung. Die innerhalb des sogenannten Components-Object definierten Objekte können über Properties außerhalb des Components-Objects referenziert werden, andernfalls haben sie keinerlei Effekt auf die API. Wer Tooling verwendet, das solche inline Referenzen nicht unterstützt, kann auf eine dereferenzierte Version zurückgreifen.

Anzeige
Anzeige

Bisher noch in Beta

Momentan befindet sich die Description in der Beta-Phase – eine zwölf Jahre alte API zu beschreiben, sei keine einfache Aufgabe, schreiben die Autoren des zugehörigen Blogposts. Erstellt wurde die Description über die Verwendung einer Mischung aus JSON-Schemata, dokumentierter Beispiele und Contract-Testing. Bei GitHub wird im Moment aktiv daran entwickelt, in Zukunft soll das Projekt zentraler Bestandteil der GitHub-Developer-Experience werden – sowohl in- als auch extern.

Für GitHub Enterprise Server sowie GitHub Private Instances sollen vierteljährlich Releases der Description verfügbar sein, häufigere Updates soll es über github.com geben, so der zugehörige Blogpost. Wer sich an dem Open-Source-Projekt beteiligen möchte, ist natürlich herzlich willkommen, alle Infos dazu findet ihr im Contribution-Guide der Description.

Anzeige
Anzeige

Mehr zum Thema:

Mehr zu diesem Thema
Fast fertig!

Bitte klicke auf den Link in der Bestätigungsmail, um deine Anmeldung abzuschließen.

Du willst noch weitere Infos zum Newsletter? Jetzt mehr erfahren

Anzeige
Anzeige
Schreib den ersten Kommentar!
Bitte beachte unsere Community-Richtlinien

Wir freuen uns über kontroverse Diskussionen, die gerne auch mal hitzig geführt werden dürfen. Beleidigende, grob anstößige, rassistische und strafrechtlich relevante Äußerungen und Beiträge tolerieren wir nicht. Bitte achte darauf, dass du keine Texte veröffentlichst, für die du keine ausdrückliche Erlaubnis des Urhebers hast. Ebenfalls nicht erlaubt ist der Missbrauch der Webangebote unter t3n.de als Werbeplattform. Die Nennung von Produktnamen, Herstellern, Dienstleistern und Websites ist nur dann zulässig, wenn damit nicht vorrangig der Zweck der Werbung verfolgt wird. Wir behalten uns vor, Beiträge, die diese Regeln verletzen, zu löschen und Accounts zeitweilig oder auf Dauer zu sperren.

Trotz all dieser notwendigen Regeln: Diskutiere kontrovers, sage anderen deine Meinung, trage mit weiterführenden Informationen zum Wissensaustausch bei, aber bleibe dabei fair und respektiere die Meinung anderer. Wir wünschen Dir viel Spaß mit den Webangeboten von t3n und freuen uns auf spannende Beiträge.

Dein t3n-Team

Melde dich mit deinem t3n Account an oder fülle die unteren Felder aus.

Bitte schalte deinen Adblocker für t3n.de aus!
Hallo und herzlich willkommen bei t3n!

Bitte schalte deinen Adblocker für t3n.de aus, um diesen Artikel zu lesen.

Wir sind ein unabhängiger Publisher mit einem Team von mehr als 75 fantastischen Menschen, aber ohne riesigen Konzern im Rücken. Banner und ähnliche Werbemittel sind für unsere Finanzierung sehr wichtig.

Schon jetzt und im Namen der gesamten t3n-Crew: vielen Dank für deine Unterstützung! 🙌

Deine t3n-Crew

Anleitung zur Deaktivierung
Artikel merken

Bitte melde dich an, um diesen Artikel in deiner persönlichen Merkliste auf t3n zu speichern.

Jetzt registrieren und merken

Du hast schon einen t3n-Account? Hier anmelden

oder
Auf Mastodon teilen

Gib die URL deiner Mastodon-Instanz ein, um den Artikel zu teilen.

Anzeige
Anzeige