OpenAPI Design-First
Design-First bedeutet: erst das API-Schema definieren, dann Code generieren. OpenAPI 3.1 ist der Standard für REST-API-Dokumentation und -Versionierung — und modernes Tooling generiert aus dem Schema Server-Stubs, Client-SDKs und Mocks automatisch. Sie lernen, wie Design-First-API-Workflows mit OpenAPI professionell umgesetzt werden.
Ziele
Sie können nach diesem Kurs Design-First-API-Workflows einführen: OpenAPI 3.1 Spezifikationen schreiben, Code aus Schemas generieren, Mock-Server für Frontend-Teams bereitstellen und API-Verträge versionieren und testen.
Behandelte Themen
Die Module im Überblick
Modul 1: OpenAPI 3.1 Spezifikation schreiben
- OpenAPI-Struktur: info, paths, components und security
- Request und Response Schemas: Pydantic-ähnliche Typen in OpenAPI
- Reusable Components: Schemas, Parameters und Responses wiederverwenden
- Neue Features in OpenAPI 3.1: JSON Schema 2020-12 und Webhooks
Modul 2: Tooling und Code-Generierung
- Swagger Editor und Stoplight Studio: Design-Tools für OpenAPI
- OpenAPI Generator: Server-Stubs und Client-SDKs generieren
- Kiota: Microsoft's Type-Safe Client-Generator für OpenAPI
- Redoc und Swagger UI: automatische API-Dokumentation aus OpenAPI
Modul 3: Mock-Server und Contract Testing
- Prism: Mock-Server aus OpenAPI-Spezifikationen
- Consumer-Driven Contract Testing: Pact für API-Verträge
- API-Versionierung: Breaking Changes erkennen mit openapi-diff
- Spectral: Linting und Style-Guide für OpenAPI-Spezifikationen
Modul 4: Design-First in der Praxis
- Design-First-Workflow: Schema → Review → Code → Tests → Docs
- CI/CD-Integration: OpenAPI-Validation in der Pipeline
- Multi-Team-Kollaboration: API-Design-Reviews und Governance
- Migration: Code-First zu Design-First migrieren
Kodschul-Trainer & Team
Lernen Sie von Experten - erfahrene Fachleute mit praktischem Know-how
Erfahrene Trainer mit praktischer Technik-Erfahrung
Über 3000 Fachkräfte in zwei Jahren geschult
Praxisnahe Expertise und tiefes Branchenwissen
Wirkungsvolles Lernen mit realen Anwendungen
Über 300+ Projekte gemeinsam abgeschlossen
Selina Schmid
Seminar Manager
Elisa Saleh
Back Office
Lars Gerigk
Portfolio Manager
Sebastian Carnal
HR & People
Ömer Akgeyik
Tech Lead
So läuft das Training ab
Unsere Schulungen sind 100% hands-on, mit einem praktischen Anteil von 70% und 30% Theorie. Sie finden vor Ort, bei uns oder online (auf allen gängigen Plattformen) statt. Zusätzlich erhalten die Teilnehmenden kostenfrei Hands-outs und Unterlagen, die sie zur Vertiefung und weiteren Anwendung nutzen können.
Grundlagen
Zu Beginn sorgen wir dafür, dass alle Teilnehmenden auf denselben Wissensstand gebracht werden, unabhängig von ihrem Ausgangsniveau. So wird jeder optimal auf die weiteren Themen vorbereitet, und niemand bleibt zurück.
Durchführung
Wir starten mit einer Einführung in das Thema, gefolgt von Demos und praxisnahen Beispielen. Anschließend üben die Teilnehmenden eigenständig, während der Trainer individuelles Feedback gibt und bei Bedarf Korrekturen vornimmt.
Anwendungsfälle
Das Gelernte wird auf konkrete Anwendungsfälle der Teilnehmenden angewendet. In einer praxisorientierten Session erarbeiten wir gemeinsam Lösungen, die den Teilnehmern helfen, das Wissen direkt in ihren Arbeitsalltag zu integrieren.
Am häufigsten gestellte Fragen
Für wen ist dieser Kurs konzipiert?
+Wie kann ich mich für den Kurs anmelden?
+Wie hoch sind die Kosten für den Kurs?
+Brauche ich Vorkenntnisse zum Thema des Kurses?
+Werde ich das Gelernte in diesem Kurs anwenden können?
+Welche Software oder Tools benötige ich für den Kurs?
+Lassen Sie uns über Ihr nächstes Training sprechen.
Unser Team steht Ihnen rund um die Uhr zur Verfügung und freut sich auf Ihre Anfrage. Einfach anrufen oder eine Nachricht hinterlassen – wir kümmern uns schnellstmöglich um Ihre Anfrage, ob es um eine Schulung, einen Vortrag oder eine Präsentation geht. Jetzt loslegen!
Selina Schmid
Leiterin Kodschul