Seminar Umbraco – Content Delivery API und Headless-Architekturen

Headless-Architekturen entkoppeln Inhaltsverwaltung und Ausgabekanäle, verschieben aber Verantwortung in Datenverträge, Cache-Strategien und Veröffentlichungsprozesse. Das Seminar behandelt daher nicht nur API-Aufrufe, sondern die vollständige Lieferkette bis zur aktualisierten Frontendanwendung.

Eine Beispielanwendung konsumiert Inhalte und Medien, verarbeitet unterschiedliche Inhaltstypen und reagiert auf Veröffentlichungen. Zusätzlich werden Vorschau, geschützte Inhalte, Fehlerfälle und versionierbare Clientmodelle berücksichtigt.

Inhaltsverzeichnis

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

Zielsetzung

Ziel ist die Planung und Implementierung einer stabilen Headless- oder Hybridlösung mit kontrollierbarer Inhaltsauslieferung, klaren Verträgen und überprüfbarer Aktualisierung.

Zielgruppe

Umbraco-Entwickler, Frontend-Entwickler, Lösungsarchitekten und Teams für mobile oder kanalübergreifende Anwendungen.

Voraussetzungen

Grundkenntnisse in Umbraco-Inhaltsmodellierung, HTTP, JSON und moderner Frontend-Entwicklung. C# ist für serverseitige Erweiterungen erforderlich.

Seminarinhalte

Die Themen werden in aufeinander aufbauenden Arbeitsschritten behandelt. Jeder Schritt wird demonstriert, in der Übungsumgebung umgesetzt und anhand festgelegter Prüfkriterien kontrolliert.

Tag 1 – API-Modell, Abfragen und Vorschau

Der erste Tag stellt ein belastbares Inhalts- und Abfragemodell bereit.

1. Schritt 1: Headless, hybrid und klassisch gerenderte Architektur anhand von Verantwortlichkeiten, Vorschauanforderungen und Betriebsfolgen vergleichen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
2. Schritt 2: Content Delivery API aktivieren, Zugriffsumfang festlegen und öffentliche von nicht öffentlichen Inhaltsbereichen klar trennen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
3. Schritt 3: Inhalte über Routen, Kennungen, Filter, Sortierung und Seitennavigation abfragen und die Auswirkungen auf Datenmenge sowie Antwortzeit prüfen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
4. Schritt 4: Medien, Blockinhalte, Referenzen und Varianten in stabile Clientmodelle übertragen und fehlende oder unbekannte Typen kontrolliert behandeln. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
5. Schritt 5: Vorschau- und Entwurfszugriffe absichern und den redaktionellen Prüfprozess zwischen Backoffice und entkoppeltem Frontend gestalten. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.

Tag 2 – Clientanwendung, Aktualisierung und Erweiterung

Der zweite Tag verbindet API, Frontend und Betrieb zu einem vollständigen Auslieferungsprozess.

1. Schritt 1: Typisierte Clientmodelle erzeugen oder pflegen und Änderungen am Inhaltsvertrag mit Versions- und Kompatibilitätsregeln absichern. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
2. Schritt 2: Server- und Client-Caching mit eindeutigen Invalidierungsregeln, Ablaufzeiten und Verhalten bei vorübergehendem API-Ausfall implementieren. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
3. Schritt 3: Veröffentlichungsereignisse für Neuaufbau, gezielte Cache-Löschung oder inkrementelle Aktualisierung des Frontends verwenden. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
4. Schritt 4: CORS, Zugriffstoken, Rate-Begrenzung, Eingabefilter und Protokollierung passend zur öffentlichen oder geschützten Nutzung konfigurieren. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
5. Schritt 5: Vertrags-, Integrations- und End-to-End-Tests für Routen, Varianten, Medien, Vorschau, Fehlerantworten und Inhaltsaktualität aufbauen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.

Praxisübungen

• Entwicklung eines typisierten Clients für mehrere Dokument- und Blocktypen.
• Umsetzung einer Listen- und Detailansicht mit Filter, Seitennavigation und Medienausgabe.
• Einrichtung einer gezielten Cache-Invalidierung nach Veröffentlichung eines Inhalts.
• Prüfung von Vorschau, geschütztem Zugriff, unbekanntem Inhaltstyp und vorübergehendem API-Ausfall.

Methodik

Kurze Fachvorträge wechseln mit Live-Demonstrationen, geführten Umsetzungen und selbstständigen Übungen. Zwischenstände werden anhand nachvollziehbarer Prüfschritte kontrolliert. Typische Fehlkonfigurationen und Störungsszenarien werden bewusst einbezogen, damit nicht nur der Normalfall, sondern auch Diagnose, Korrektur und sichere Rücknahme beherrscht werden.