Seminar Mezzio – REST-APIs mit HAL, Problem Details, CORS und Valinor

Eine gute API ist mehr als ein JSON-Array hinter einer Route. Ressourcen, Statuscodes, Header, Fehlerformate und Eingabedaten bilden einen Vertrag, der auch bei späteren Änderungen stabil bleiben muss.

Seminarüberblick

Die Teilnehmenden entwickeln eine kleine, versionierbare API mit klaren Handlern und einer separaten Anwendungsschicht. Eingabedaten werden früh typisiert und validiert, Repräsentationen über HAL aufgebaut und Fehler konsistent als Problem Details ausgegeben. CORS und Authentifizierungsgrenzen werden in die Pipeline eingeordnet.

Zielgruppe

PHP- und Mezzio-Entwickler, Softwarearchitekten und API-Verantwortliche, die neue REST-APIs entwickeln oder uneinheitliche JSON-Endpunkte konsolidieren möchten.

Voraussetzungen

Gute PHP- und Mezzio-Grundkenntnisse, Erfahrung mit Routing, Middleware und Dependency Injection sowie Grundlagen zu HTTP und REST.

Seminarinhalte

API-Vertrag und Ressourcenmodell

• Ressourcen, Collection- und Entity-Operationen sowie URI-Strukturen entwerfen
• HTTP-Methoden, Statuscodes, Header und Idempotenz korrekt anwenden
• Versionierung und kompatible Änderungen bewusst planen

Handler und typisierte Eingaben

• API-Handler von Fachlogik und Persistenz entkoppeln
• Request-Bodies, Query- und Routenparameter kontrolliert zusammenführen
• Valinor-Middleware für typisierte Datenstrukturen und klare Fehlergrenzen einsetzen

HAL-Repräsentationen

• Ressourcen, Links und eingebettete Ressourcen modellieren
• Objekte und Collections über Resource Generatoren abbilden
• Pagination und relationale Verweise ohne Datenbankdetails nach außen darstellen

Problem Details und CORS

• Technische und fachliche Fehler in konsistente Problemantworten überführen
• Ausnahmen, Validierungsfehler und nicht gefundene Ressourcen unterscheiden
• Projekt- und routebezogene CORS-Regeln einschließlich Preflight-Anfragen konfigurieren

Sicherheit und Tests

• Authentifizierung und Autorisierung an der richtigen Stelle der API-Pipeline verankern
• Vertrags-, Integrations- und Negativtests für Header, Statuscodes und Payloads erstellen
• Logging und Korrelation ohne Offenlegung sensibler Inhalte umsetzen

Praxis im Seminar

Eine API mit Collection, Einzelressource und geschützter Schreiboperation wird umgesetzt. Die Teilnehmenden ergänzen typisierte Eingaben, HAL-Links, Problemantworten, CORS-Regeln und automatisierte Vertragstests.