// Softwarearchitektur

API-Design und Versionierung

Langlebige Schnittstellen entwerfen, versionieren und weiterentwickeln.

  • Inhouse-Schulung
  • 1 Tag
  • Fortgeschritten
  • Remote oder vor Ort
  • KI-Werkzeug
Weißes Architekturmodell auf Transparentpapier mit Grundriss, daneben ein Zeichendreieck
Symbolbild · KI-generiert

Was Sie mitnehmen

  • Sie entwerfen REST-Schnittstellen nach klaren Konventionen für Ressourcen, Fehler und Paginierung.
  • Sie beschreiben APIs mit OpenAPI und generieren Code mit OpenAPI Generator.
  • Sie wählen eine Versionierungsstrategie und entwickeln APIs kompatibel weiter.
  • Sie prüfen API-Entwürfe mit KI gegen Designrichtlinien und bewerten die Befunde.

Agenda

Die Agenda ist die Grundlage. Schwerpunkte und Beispiele stimmen wir vorab auf Ihr Team ab.

Vormittag

  • Ressourcenmodell, HTTP-Methoden, Statuscodes und Idempotenz
  • Fehlerformat nach RFC 9457, Paginierung, Filter und Sortierung
  • API-first mit OpenAPI: Spezifikation, Wiederverwendung, Beispiele
  • Übung: OpenAPI-Spezifikation für einen Anwendungsfall entwerfen

Nachmittag

  • Code-Generierung mit OpenAPI Generator für Server und Client
  • Versionierung über Pfad, Header oder Medientyp, Deprecation
  • Kompatible Änderungen erkennen und Breaking Changes vermeiden
  • Übung: API-Entwurf mit KI gegen Designrichtlinien prüfen und überarbeiten

KI in dieser Schulung

// KI als Werkzeug im Entwicklungsalltag

API-Entwürfe mit KI gegen Designrichtlinien prüfen.

Voraussetzungen und Rahmen

Vorwissen
Erfahrung mit der Entwicklung von REST-Schnittstellen in Java. Für den KI-Teil ein lokales Modell mit Ollama und Continue, Hardware vorab klären.
Werkzeuge
OpenAPI Generator (Open Source, Apache 2.0)
Niveau
Fortgeschritten
Teilnehmende
bis 10 Personen, größere Gruppen auf Anfrage
Durchführung
Remote per Videokonferenz oder bei Ihnen vor Ort
Enthalten
Abstimmung vorab, Unterlagen, Übungsprojekte, Teilnahmebescheinigungen

// Trainer mit langjähriger Softwareentwicklungserfahrung, akademische Ausbildung in Informatik und KI.