Seminar Phoenix APIs und Integrationen

Im Mittelpunkt stehen belastbare HTTP-Schnittstellen für Browser-Clients, mobile Anwendungen und Systemkopplungen. Die Teilnehmenden entwickeln eine konsistente JSON-API, die Eingaben sauber validiert, Fehler nachvollziehbar behandelt und sich automatisiert prüfen lässt.

Ziel und Nutzen

Das Training vermittelt einen durchgängigen Ansatz von der Ressourcenmodellierung über Routing und Controller bis zur Datenzugriffsschicht. Nach dem Seminar können die Teilnehmenden Schnittstellen so strukturieren, dass Verträge verständlich, Erweiterungen beherrschbar und betriebliche Fehler diagnostizierbar bleiben.

Zielgruppe

Elixir- und Phoenix-Entwickler, Backend-Entwickler, Integrationsentwickler sowie technische Architekten, die HTTP-basierte Dienste erstellen oder bestehende Schnittstellen modernisieren.

Voraussetzungen

Sichere Elixir-Grundlagen, grundlegende Phoenix-Kenntnisse sowie ein Verständnis von HTTP, JSON und relationalen Datenbanken. Für die Übungen wird Erfahrung mit Git und der Kommandozeile vorausgesetzt.

Themenschwerpunkte

• Aufbau eines API-orientierten Projekts und Einordnung des Request-Lebenszyklus
• Router-Scopes, Pipelines, Plugs und klare Trennung öffentlicher und geschützter Endpunkte
• Ressourcen, Statuscodes, konsistente Namenskonventionen und evolutionsfähige API-Verträge
• Controller, JSON-Rendering, zentrale Fehlerbehandlung und Action-Fallbacks
• Parameterprüfung mit Changesets sowie verständliche Validierungs- und Domänenfehler
• Paginierung, Filterung, Sortierung und effiziente Ecto-Abfragen
• Transaktionen, Idempotenz und der Umgang mit konkurrierenden Änderungen
• Token-basierte Authentifizierung, Autorisierung und sichere Mandantengrenzen
• CORS, Rate-Limiting-Konzepte, Größenbegrenzungen und Schutz vor missbräuchlichen Anfragen
• Anbindung externer Dienste, Zeitüberschreitungen, Wiederholungen und kontrollierte Fehlerkaskaden
• Automatisierte Controller-, Context- und Integrationsprüfungen
• Protokollierung, Metriken und Diagnose von Schnittstellen im Betrieb

Praxis und Methoden

Die Teilnehmenden bauen schrittweise eine fachlich zusammenhängende API. Jede Übung erweitert denselben Anwendungsfall um Validierung, Datenzugriff, Authentifizierung, Fehlerverträge und Tests. Code-Reviews und kurze Architekturentscheidungen sorgen dafür, dass nicht nur funktionierender, sondern auch wartbarer Code entsteht.

Einordnung

Der Schwerpunkt liegt auf Phoenix-eigenen JSON- und HTTP-Mitteln. GraphQL wird zur technologischen Einordnung behandelt, ist jedoch nicht Gegenstand einer vollständigen Implementierung. Tiefe Datenbankoptimierung und produktionsweite Plattformthemen werden in den Seminaren zu Ecto, Performance und Betrieb vertieft.