Aus dem Kurs: ASP.NET Core 3.1 Web API Grundkurs
So erhalten Sie Zugriff auf diesen Kurs
Werden Sie noch heute Mitglied und erhalten Sie Zugriff auf mehr als 23.200 Kurse von Branchenfachleuten.
APIs dokumentieren – Tutorial zu ASP.NET Core
Aus dem Kurs: ASP.NET Core 3.1 Web API Grundkurs
APIs dokumentieren
Eine API gehört dokumentiert, eine öffentliche sowieso, aber auch eine nicht öffentliche. Irgendwann haben wir auch Nachfolger und die müssen mit dem arbeiten, was wir geschaffen haben. Außerdem hat ja eine API viele Clients, die sie konsumieren und auch diejenigen Personen, die diese Clients erstellen, müssen wissen, was sie tun können und tun sollen. Jetzt gibt es ja auch diverse Möglichkeiten, Versuche, bestimmte Dinge zu standardisieren und ich will Ihnen einen ganz bestimmten Weg aufzeigen, der ist nämlich ziemlich populär und, wie ich finde, auch ganz praktisch. Und zwar will ich kurz über Swagger sprechen. Swagger ist ein Framework eben für die Dokumentation von APIs, also ein komplettes Rahmenwerk, wo wir dann diverseste Möglichkeiten haben für eine Dokumentation und wie wir Dokumentationsinformationen bereitstellen für beispielsweise Oberflächen, die diese Versionsinformationen und API-Informationen visualisieren. Zufällig gibt es da auch noch ein weiteres Projekt, nämlich…
Üben mit Projektdateien
Laden Sie die Dateien herunter, die von den Trainer:innen verwendet werden. So können Sie mitlesen und durch Ansehen, Zuhören und Üben lernen.
Inhalt
-
-
-
-
-
-
-
Möglichkeiten der API-Versionierung3 Min. 25 Sek.
-
(Gesperrt)
Microsoft Versionierungs-Bibliothek2 Min. 2 Sek.
-
(Gesperrt)
Versionierung per URL7 Min. 20 Sek.
-
(Gesperrt)
Versionierung per HTTP-Header3 Min. 28 Sek.
-
(Gesperrt)
Versionierung per QueryString1 Min. 27 Sek.
-
(Gesperrt)
APIs dokumentieren8 Min. 43 Sek.
-
-