Seminar Ibexa DXP API- und Headless-Entwicklung

Dieses Seminar führt von den Domänenkonzepten des Content Repository bis zu einer belastbaren entkoppelten Webanwendung. Es verbindet die verfügbaren Schnittstellen mit typischen Anforderungen moderner Frontends, Apps und Integrationsdienste.

Seminarziel

Die Teilnehmenden können passende APIs auswählen, Inhalte und Strukturen sicher lesen und verändern, Such- und Sprachkonzepte umsetzen, Authentifizierung und Berechtigungen berücksichtigen sowie ein Headless-Frontend produktionsnah anbinden.

Zielgruppe

Das Seminar richtet sich an Backend- und Frontend-Entwickler, Integratoren, technische Architekten und Teams, die Ibexa DXP als Headless CMS oder als zentrale Content- und Produktplattform einsetzen.

Voraussetzungen

Erforderlich sind Kenntnisse in HTTP, JSON, Web-APIs und mindestens einer Programmiersprache. Erfahrung mit Git, Authentifizierungsverfahren und modernen Frontend- oder Backend-Frameworks ist von Vorteil.

Inhalte

Headless-Architektur und Domänenmodell

• Content, Content Type, Field, Location, Version, Sprache und SiteAccess als API-relevante Konzepte
• Abgrenzung und Zusammenspiel von REST API, GraphQL API und öffentlicher PHP API
• Entkopplungsgrade, Backend-for-Frontend, serverseitiges Rendering und Single-Page-Anwendungen
• Editionen, Funktionsverfügbarkeit und technische Entscheidungsregeln

REST API in der Praxis

• Ressourcen, Medienformate, Content-Negotiation, Statuscodes und Fehlerbehandlung
• Lesen, Anlegen, Bearbeiten, Versionieren und Publizieren von Inhalten
• Content Types, Benutzer, Sprachen, Locations und Suchendpunkte
• OpenAPI-Beschreibung, Client-Generierung und reproduzierbare Request-Sammlungen

GraphQL und strukturierte Abfragen

• Schemaaufbau aus Content Types und Field Definitions
• Abfragen von Feldern, Relationen, Listen, Sprachen und paginierten Ergebnissen
• Umgang mit Schemaänderungen, Fragmenten, Fehlern und Leistungsgrenzen
• Entscheidung zwischen GraphQL, REST und serverseitiger PHP-Integration

Authentifizierung und Berechtigungen

• Session-basierter Zugriff, Token-Verfahren und JWT-Konfiguration für APIs
• Rollen, Policies und Limitations als Grundlage jedes API-Ergebnisses
• CORS, Geheimnisse, sichere Clients, Rate-Limits und Schutz sensibler Endpunkte
• Technische Benutzer, Dienstkonten und nachvollziehbare Zugriffskonzepte

Frontend-Integration

• Routing, URL-Auflösung, Mehrsprachigkeit, Fallbacks und SiteAccess-Zuordnung
• Medien, RichText, eingebettete Inhalte und normalisierte View-Modelle
• Vorschau redaktioneller Entwürfe, Fehlerseiten und robuste Ladezustände
• Cache-Strategien, Invalidierung, HTTP-Header und Content-Aktualität

Qualität und Betrieb

• Vertragstests, Integrationstests, Mocking und Testdaten
• Observability, strukturierte Logs, Tracing und Diagnose fehlerhafter Requests
• Versionskompatibilität, API-Änderungen und resiliente Client-Implementierung
• Deployment- und Sicherheitscheckliste für entkoppelte Anwendungen

Praxisanteil

Die Teilnehmenden implementieren schrittweise einen kleinen Headless-Client, lesen mehrsprachige Inhalte, führen Suchabfragen aus, sichern Zugriffe ab und ergänzen Vorschau, Caching sowie automatisierte Schnittstellentests.

Einordnung und Vertiefung

Der Schwerpunkt liegt auf Schnittstellen und entkoppelten Frontends. Die interne Erweiterungsarchitektur von Ibexa DXP wird im fünftägigen Entwicklerseminar vertieft.