Bereitstellung veröffentlichter Beiträge

Die Content-API stellt ausschließlich veröffentlichte Beiträge bereit und macht Titel, Textkörper und Beitragsbilder für jede Anwendung mit einem gültigen Content-Schlüssel zugänglich. Ein Beam-Agent liest diesen Feed nach Zeitplan oder per Webhook aus, gleicht ihn mit den freigegebenen Regeln des Kunden ab – beispielsweise, dass jeder für einen bestimmten Website-Bereich markierte Beitrag in einem verknüpften Verzeichnis erscheinen soll – und aktualisiert das Zielverzeichnis mit dem neuen Eintrag. Entwürfe oder geplante Beiträge werden dabei nie berührt, da die Content-API diese überhaupt nicht erfassen kann. Alles, was die Formulierung oder Kategorisierung eines Beitrags vor der Veröffentlichung betrifft, wird an ein menschliches Redaktionsmitglied im Admin-Bereich weitergeleitet.

Filterung nach Tags und Autoren

Jeder veröffentlichte Beitrag enthält Tags und Autorenfelder, die von der Content-API zusammen mit dem Textkörper zurückgegeben werden. Ein Beam-Agent filtert diesen Feed nach den Tags oder Autoren, die für den Kunden relevant sind – sammelt beispielsweise nur Beiträge, die für einen Newsletter markiert sind – und wendet die freigegebene Regel an, wie das Hinzufügen der passenden Einträge zu einem Digest-Dokument oder einer internen Liste. Er stützt sich ausschließlich auf die von Ghost zurückgegebenen Felder, auf nichts anderes. Alles, was ein fehlendes Tag, eine unklare Autorennennung oder einen scheinbar falsch kategorisierten Beitrag betrifft, wird an ein menschliches Redaktionsmitglied zur Korrektur an der Quelle weitergeleitet, da der Agent Beiträge über diese API nicht bearbeiten kann.

Schreibgeschützter öffentlicher Zugriff

Die Content-API ist für den öffentlichen, schreibgeschützten Zugriff ausgelegt, sodass sie hinter einer Website oder App geschaltet werden kann, ohne den Admin-Bereich offenzulegen. Ein Beam-Agent nutzt diesen Schlüssel, um nach neuen veröffentlichten Beiträgen zu suchen, und wendet die freigegebene Regel an, beispielsweise um einen Marketingkanal zu benachrichtigen, wenn ein Beitrag mit einem bestimmten Tag live geht, oder um ihn einem Content-Kalender hinzuzufügen. Über diesen Schlüssel kann er bauartbedingt weder Entwürfe erstellen, noch Beiträge bearbeiten oder offline nehmen. Alles, was eine Änderung am Beitrag selbst erfordert, wie das Beheben eines von einem Leser gemeldeten Fehlers, wird an eine Person mit Admin-Zugriff weitergeleitet, da dieser Schlüssel allein keine Schreibrechte erlaubt.