In diesem zweitägigen Training lernst du, wie HTTP APIs entworfen und mit Hilfe von OpenAPI dokumentiert werden. Am Ende wirst du in der Lage sein, die erlernten Konzepte in eigenen Projekten anzuwenden und gelungene HTTP APIs zu entwerfen.
Ein Schwerpunkt des Trainings liegt auf dem Einsatz von Best Practices beim Design der Schnittstelle und der Einhaltung wichtiger Qualitätsmerkmale, wie Konsistenz, Verständlichkeit und Erweiterbarkeit. Zudem werden weitere wichtige Themen für API-Anbieter diskutiert, wie etwa Strategien für die Versionierung von APIs, Dokumentation und API Design Guidelines.
Warum API Design wichtig ist: HTTP APIs haben sich in den vergangenen Jahren als eines der wichtigsten Werkzeuge zur Systemintegration etabliert. Früher oder später steht jede(r) Entwickler:in vor der Aufgabe, eine solche Schnittstelle zu implementieren. Da der reine Programmieraufwand überschaubar ist, kommt in der Hektik des Projektalltags leider häufig das Design der Schnittstelle zu kurz. Dies führt dann mittelfristig zu allerlei unschönen Herausforderungen, etwa wenn die Schnittstelle sich als schlecht verständlich erweist oder nur schwierig erweiterbar ist. Daher ist es wichtig, sich bereits vor Inbetriebnahme einer Schnittstelle eingehende Gedanken über das API Design zu machen. In diesem Training lernst du, worauf hierbei zu achten ist.