Uit de cursus: Basisbeginselen van programmeren: API's en webservices

Krijg toegang tot deze cursus met een gratis proefabonnement

Word vandaag lid en krijg toegang tot meer dan 23.100 cursussen geleid door branchedeskundigen.

Een API documenteren

Een API documenteren

- [Instructeur] Laten we het hebben over het documenteren van een API. Waar we naar gaan kijken is erg handig voor ontwikkelaars en software engineers die een bestaande webservice in hun applicaties moeten gebruiken of gebruiken. Swagger is de tool bij uitstek voor het documenteren van een API en het is een tool waarmee u kunt begrijpen hoe een API werkt. Bij het maken van een REST API is goede documentatie instrumenteel en het up-to-date houden van die documentatie bij elke nieuwe wijziging is ook instrumenteel. Dit handmatig bereiken is een vervelende oefening. Automatisering, via Swagger, is dus een tijdsbesparing. En dus is dit slechts een voorbeeld uit het voorbeeld van Swagger Petstore dat de API en alle verschillende functies en bewerkingen erop laat zien. Nu meer over Swagger. Swagger is een set open-source tools gebouwd rond de OpenAPI-specificatie en ik laat de specificatie hier zien. Dus deze specificatie definieert een standaard en het is programmeertaal-agnostisch en…

Inhoud