Seminar Ibexa DXP – Headless-Entwicklung mit REST und GraphQL

Die Schulung zeigt, wie strukturierte Inhalte aus Ibexa DXP sicher und kanalunabhängig bereitgestellt werden. REST, GraphQL, Authentifizierung, Abfragen, Mutationen, Medien, Cache, Fehlerverträge und Client-Architektur werden in einem vollständigen Headless-Szenario umgesetzt.

Inhaltsübersicht

• Zielsetzung
• Zielgruppe
• Voraussetzungen
• Seminarinhalte
• Praxisübungen
• Methodik

Zielsetzung

• REST- und GraphQL-Zugriffe nach Anwendungsfall und Datenbedarf auswählen.
• Authentifizierung, Berechtigung, Abfrageumfang und Fehlerbehandlung sicher gestalten.
• Content, Locations, Relationen, Übersetzungen und Medien effizient ausliefern.
• Clients mit Caching, Vorschau, Tests und Betriebsbeobachtung belastbar integrieren.

Zielgruppe

Frontend- und App-Entwickler, Integrationsentwickler, Solution-Architekten, API-Verantwortliche und technische Teams für Headless-Websites, Portale oder mobile Anwendungen.

Voraussetzungen

Programmierkenntnisse, Verständnis von HTTP, JSON, API-Design und Authentifizierung. Grundkenntnisse von Ibexa-DXP-Content-Modell, Locations und Berechtigungen sind erforderlich.

Seminarinhalte

1. Schritt 1: Headless-Anwendungsfall abgrenzen

   Kanäle, Nutzer, Inhalte, Aktualität, Schreibbedarf, Vorschau, Personalisierung und nichtfunktionale Anforderungen werden als API-Vertrag beschrieben.

2. Schritt 2: REST und GraphQL vergleichen

   Ressourcenorientierte Zugriffe, flexible Abfragen, Schema, Caching, Client-Komplexität und Schreiboperationen werden nach Eignung bewertet.

3. Schritt 3: Authentifizierung und Rechte planen

   Anonyme, angemeldete und technische Clients erhalten klar begrenzte Identitäten, Rollen, Token-Lebenszyklen und Schutzmaßnahmen.

4. Schritt 4: Content und Locations lesen

   Identität, Platzierung, Version, Sprache, Sichtbarkeit und URL werden korrekt unterschieden und in ein stabiles Clientmodell überführt.

5. Schritt 5: GraphQL-Abfragen entwickeln

   Schema, Typen, Fragmente, Variablen, Relationen, Pagination und Fehler werden für eine komponentenorientierte Datenabfrage eingesetzt.

6. Schritt 6: REST-Operationen umsetzen

   Ressourcen, Header, Sprachkontext, Formate, Statuscodes, ETags und Schreibvorgänge werden mit nachvollziehbarer Fehlerbehandlung genutzt.

7. Schritt 7: Medien und Rich Content ausliefern

   Bildvarianten, Binärdaten, alternative Texte, eingebettete Inhalte und Links werden kanalgeeignet transformiert.

8. Schritt 8: Mehrsprachigkeit und Sites berücksichtigen

   SiteAccess, Sprache, Fallback, Domainkontext und URL-Bildung werden im Client und in der API-Konfiguration konsistent behandelt.

9. Schritt 9: Vorschau und Entwürfe organisieren

   Entwurfszugriff, Preview-Kontext, geschützte Routen und Trennung von Produktionsdaten werden für redaktionelle Abnahmen umgesetzt.

10. Schritt 10: Caching und Aktualisierung gestalten

    HTTP-Cache, Client-Cache, ETags, Invalidierung, Revalidierung und zeitkritische Daten werden nach Content-Lebenszyklus geplant.

11. Schritt 11: Fehler- und Resilienzkonzept entwickeln

    Timeouts, Rate Limits, nicht gefundene Inhalte, Teilfehler, Wiederholung und Fallback-Anzeigen werden als definierte Clientreaktionen implementiert.

12. Schritt 12: API-Integration testen und betreiben

    Vertragstests, Berechtigungstests, Lastprofile, Protokolle, Metriken und Versionsänderungen werden in den Liefer- und Betriebsprozess integriert.

Praxisübungen

• GraphQL-Abfrage für eine mehrsprachige Komponentenansicht entwickeln.
• REST-Zugriff auf Content und Locations mit Sprach- und Berechtigungskontext umsetzen.
• Preview-Pfad für einen unveröffentlichten Entwurf entwerfen.
• Cache- und Invalidierungsstrategie für eine Headless-Webanwendung formulieren.
• Vertrags- und Fehlerfälle für einen mobilen Client testen.

Methodik

Ein Referenzclient ruft reale Content-Strukturen ab und verarbeitet sie komponentenorientiert. REST und GraphQL werden vergleichend eingesetzt; Sicherheit, Cache und Fehlerszenarien sind Bestandteil jeder Übung.