Seminar Laravel APIs mit REST und JSON:API

Inhaltsübersicht

• Seminarprofil
• Lernziele
• Inhalte
• Praxisübungen
• Zielgruppe und Voraussetzungen

Seminarprofil

Das Seminar behandelt API-Entwicklung als durchgängige technische Disziplin: vom stabilen Ressourcenmodell über konsistente HTTP-Verträge bis zu Authentifizierung, Fehlerbehandlung, Tests und Betrieb. Die Umsetzung erfolgt an einer zusammenhängenden Geschäftsanwendung statt an isolierten Endpunkten.

Klassische Laravel API Resources und die JSON:API-Ressourcen von Laravel 13 werden gegenübergestellt. Dadurch lässt sich entscheiden, wann eine schlanke projektspezifische REST-API ausreicht und wann standardisierte Beziehungen, Includes und Feldselektion den höheren Nutzen liefern.

Lernziele

• Ressourcen und Endpunkte fachlich konsistent modellieren
• Routing, Controller, Form Requests und Eloquent sauber voneinander trennen
• REST-Antworten und JSON:API-Ressourcen korrekt serialisieren
• Token-, Sitzungs- und OAuth-Szenarien technisch passend auswählen
• Rate Limits, Fehlerformate, Pagination und Filter stabil implementieren
• API-Verträge mit Feature-, Datenbank- und Sicherheitstests absichern

Inhalte

HTTP-Verträge und Ressourcenmodell

Ableitung stabiler Ressourcen aus fachlichen Anwendungsfällen, sinnvolle URI-Strukturen, Methoden, Statuscodes, Idempotenz, Content Negotiation und einheitliche Fehlerantworten.

• Ressourcen statt Aktionen
• Statuscodes und Header
• Idempotente Schreiboperationen
• Fehler- und Validierungsformat

Routing, Controller und Eingabevalidierung

Aufbau schlanker Controller mit Route Model Binding, Form Requests, Policies und serviceorientierter Anwendungslogik. Trennung zwischen Transport-, Anwendungs- und Persistenzschicht.

• API-Routen und Middleware
• Route Model Binding
• Form Requests
• Policies und Attribute

Eloquent, Ressourcen und Serialisierung

Effiziente Abfragen, kontrolliertes Eager Loading, Pagination, Transformation, bedingte Felder und Beziehungen sowie Schutz vor unbeabsichtigter Datenfreigabe.

• API Resources
• Beziehungsauflösung
• Pagination und Cursor
• N+1-Vermeidung

JSON:API-Ressourcen in Laravel 13

Standardisierte Ressourcenobjekte, Beziehungen, Includes, Links, Sparse Fieldsets und JSON:API-konforme Antwortheader. Planung einer konsistenten Ressourcenlandschaft.

• Resource Objects
• Includes und Relationships
• Feldselektion
• Links und Metainformationen

Authentifizierung und Schutzmechanismen

Auswahl zwischen Cookie-basierter SPA-Authentifizierung, persönlichen Zugriffstoken und OAuth-Szenarien. Ergänzend werden Autorisierung, Rate Limiting, Request Forgery, CORS-Konfiguration und sichere Fehlerausgaben behandelt.

• Sanctum-Szenarien
• OAuth-Grundlagen
• Gates und Policies
• Rate Limiting und Missbrauchsschutz

Versionierung, Tests und Betrieb

Kompatible Weiterentwicklung von Verträgen, Deprecation-Strategien, automatisierte HTTP- und Datenbanktests, Fakes für externe Systeme sowie Protokollierung und Monitoring.

• Versionsstrategien
• Contract- und Feature-Tests
• Testdaten mit Factories
• Logging, Metriken und Fehleranalyse

Praxisübungen

1. Schritt 1: Ressourcen, Operationen und Fehlerkonventionen für eine Beispielanwendung festlegen.
2. Schritt 2: Lesende und schreibende Endpunkte mit Form Requests, Policies und Eloquent implementieren.
3. Schritt 3: Antworten zunächst mit API Resources und anschließend mit JSON:API-Ressourcen abbilden.
4. Schritt 4: Authentifizierung, Rate Limits und Autorisierung ergänzen.
5. Schritt 5: Feature-, Datenbank- und Missbrauchstests ausführen.
6. Schritt 6: Versionierungs- und Deployment-Regeln dokumentieren und einen kompatiblen Änderungsfall umsetzen.

Zielgruppe und Voraussetzungen

Zielgruppe: PHP- und Laravel-Entwickler, Backend-Entwickler, Full-Stack-Entwickler und technische Architekten, die interne oder öffentliche Schnittstellen entwickeln.

Voraussetzungen: Solide PHP-Kenntnisse sowie praktische Laravel-Grundlagen in Routing, Controllern, Validierung und Eloquent. Grundkenntnisse von HTTP sind hilfreich.