OpenAPI 3 Tutorial - API Beschreibung mit Swagger - Kompletter Kurs

preview_player
Показать описание
Im #OpenAPI 3 Tutorial lernst du wie ein #API von Anfang an Schritt für Schritt beschrieben wird. Alle wichtigen Features der Swagger Version 3 werden in diesem Kurs vorgestellt und eingesetzt. Zum Mitmachen benötigst du nur einen Swagger Editor oder ein Plugin für deine IDE.

Links und Werkzeuge findest du auf unserer Homepage:

Inhalt:
00:00 Einleitung
01:07 Start Tutorial
02:42 Endpunkt mit Pfad und Methode
04:20 Tags
05:16 JSON Schema Component
07:20 Request Body
08:10 JSON Pointer
08:42 Beispiele für Datenstrukturen
09:56 Components
20:48 Responses
23:25 Parameters
24:22 PUT
25:57 DELETE
26:45 Dokumentation
32:25 Hypermedia mit Links
36:06 Query Parameter
37:50 Header Parameter
39:53 Markdown Dokumentation
41:58 Security Schema

Lerne OpenAPI in unseren API Schulungen:

REST APIs - Die Einführung

REST und API Design mit Swagger

REST & API Security:

Mehr über uns findest du unter:

Social:
@thomasub
Рекомендации по теме
Комментарии
Автор

Ein wirklich sehr gutes Video! Bin erst vor knappen zwei Monaten in die API-Entwicklung eingestiegen und habe nicht viel gutes an Tutorials zu openAPI gefunden. Du erklärst es entspannt und angenehm, man kann dir sehr gut folgen. Das Temp ist genau richtig um mit dir mit zu coden ;)

OnwTwoDerLeviathan
Автор

Bomben Video, die anderen Kommentare fassen es wirklich gut zusammen, sehr stark.

ericzoona_
Автор

sehr cool, danke!
Aber bitte beim DELETE doch lieber ein 204 Response :D

SebastianKnopp
Автор

Kleiner Hinweis: auf der Webseite fehlt das korrekte Codebeispiel… ansonsten ein super Video!! <3

nilooi
Автор

Hat jemand auch Probleme wenn man einen Request Header in Parameters definiert? Ich bekomme immer den Fehler Parameters X has a Location Header; ignore. Laut den OpenAPI specs sollte das ja erlaubt sein.

jenot
Автор

Swaggerhub hat momentan 14 Tag "Enterprise Trial", dann sind enterprisemäßige Gebühren fällig. Kann jemand Alternativen für den Hausgebrauch empfehlen?

anonymous_
Автор

Gibts ein solches Tutuorial auch für GET Endpoints?

boheme
Автор

GET _return entity(entities)_ HTTP 200 OK
PUT _create entity_ HTTP 201 Created
PATCH _update_ HTTP 200 OK
POST _create or update entity_ HTTP 200 OK bzw HTTP 201 OK

You could ignore PUT (create) and PATCH (update).
Because _POST /path/to/modelle_ (without id) is a create request (~"this entity to this entities|path").
And _POST /path/to/modelle/{id}_ is an update request (~"this data to the entity with id ...")

CottonInDerTube