Zum Inhalt springen
Delivery API
Bevor Sie eine Funktion fest einplanen, prüfen Sie den Funktionsstatus.

ÜberblickHier starten

So funktioniert Atlas

Organisationen, Sites, Umgebungen, Site-Contract, Veröffentlichung und Auslieferung auf einer Seite.

Diese Seite wurde aus dem Englischen übersetzt. Bei Abweichungen gilt die englische Version. Auf Englisch lesen

Konzept Was es ist
Organisation Ihr Unternehmen. Es besitzt Sites, Personen und seinen Tarif.
Site Eine Website. Inhalte, Medien, Zugriffsrechte und Einstellungen werden nie zwischen Sites geteilt.
Umgebung Jede Site hat Development und Production. Sie arbeiten in Development; Production liefert nur ein freigegebenes Release aus.
Site-Contract Eine JSON-Beschreibung Ihrer Website: ihre Komponenten mit typisierten Feldern, Seitentypen, Collections, Header-/Footer-Globals, Medienprofile und Design-Tokens.
Seite Eine Route Ihrer Website (zum Beispiel /about), aufgebaut aus Abschnitten. Jeder Abschnitt ist eine Komponente aus Ihrem Contract, mit seinen Feldwerten.
Eintrag Ein einzelnes Element einer Collection, etwa ein Produkt oder ein Nachrichtenartikel.
Global Inhalte, die über mehrere Seiten geteilt werden, etwa Header und Footer der Site.
Delivery-Token Ein nur für Server bestimmtes Token, mit dem Ihre Website veröffentlichte Inhalte einer Umgebung liest.
Editor in Studio ──draft──▶ Atlas (Development) ──publish──▶ published revision
│
your website server ◀── Delivery API (HTTPS, delivery token)
│
your components render it ──▶ visitors
  1. Ihre Entwickler beschreiben die Website im Site-Contract. Ein Site-Admin aktiviert ihn in Studio.
  2. Redakteure erstellen und ändern Seiten und Einträge als Entwürfe. Entwürfe erscheinen nie auf der öffentlichen Website.
  3. Redakteure sehen eine Vorschau des Entwurfs im echten Design Ihrer Website und veröffentlichen ihn dann. Jede Veröffentlichung ist eine unveränderliche Revision, sodass Sie zurücksetzen können.
  4. Ihre Website liest veröffentlichte Inhalte mit ihrem Delivery-Token aus der Delivery API, ausschließlich aus Servercode.
  5. Atlas sendet bei der Veröffentlichung einen signierten Webhook, damit Ihre Website nur die betroffenen Seiten aktualisiert.
  • Jede neue Site startet in Development. Inhalte werden dort bearbeitet und veröffentlicht.
  • Production ist ausgeschaltet, bis ein Site-Admin sie einschaltet, nachdem ein Release alle Prüfungen bestanden hat und eine Person mit Freigaberechten es freigegeben hat.
  • Production liefert nur ihr aktives, signiertes Release aus: einen eingefrorenen Stand freigegebener Inhalte. Änderungen in Development ändern Production nie bis zum nächsten freigegebenen Release.
  • Das Umschalten der Umgebung in Studio ändert nur, was Sie gerade ansehen. Es ändert nie Inhalte.

Mehr dazu: Development und Production.

Atlas läuft nicht auf Ihrer Website. Ihre Entwickler ergänzen etwas Code:

  • einen nur serverseitigen Client für die Delivery API;
  • das Rendern von Abschnitten über Ihre vorhandenen Komponenten;
  • einen Fallback: Wenn Atlas nicht erreichbar ist oder für eine Seite nichts veröffentlicht ist, liefert die Site ihre integrierten Inhalte aus;
  • eine Route für die Entwurfsvorschau, einen Webhook-Empfänger und einen Build-Bericht.

Die Anbindungsanleitung führt durch jeden dieser Punkte.