Anbindungen
Anleitung zur Website-Anbindung
Wie Änderungen auf Ihre Website gelangen, hängt davon ab, wie sie gebaut ist. Beginnen Sie mit einer Testwebsite und Testdaten und prüfen Sie, wohin jede Änderung geht und ob sie veröffentlicht wird.
Sie sind kein Entwickler? Die Einrichtungsanleitung erklärt die Verbindung mit Google und WordPress mit Screenshots.
Gemeinsame Vorbereitung
Die API für individuelle Websites und die CMS-Entwurfsjobs setzen einen aktiven Growth- oder Pro-Plan, eine bestätigte Inhaberprüfung der Website und die Freigabe jeder Änderung durch den Inhaber voraus. Bestätigen Sie die Inhaberschaft auf dem Bildschirm Connections und erstellen Sie dann auf dem Bildschirm API einen Schlüssel, der Ergebnisse festhalten kann. Ein API-Schlüssel allein kann keine Änderungen freigeben.
Ordnen Sie jede HTTPS-Seiten-URL und jedes Änderungsfeld einzeln dem CMS-Datensatz und Feld zu, das tatsächlich auf dieser Seite erscheint. Bereiten Sie vorher Testdaten, eine verantwortliche Person und Ihren Veröffentlichungsablauf vor.
Individuell entwickelte Websites
Setzen Sie die Verarbeitung auf dem Server Ihrer Website gemäß der Spezifikation der Änderungs-API um. Rufen Sie freigegebene Änderungen ab, prüfen Sie URL und Feld gegen eine Allowlist und speichern Sie einen Entwurf nur, wenn der aktuelle Wert dem Wert „vorher“ entspricht. Melden Sie die gespeicherte Version und das Ergebnis an die API zurück.
Unterstützte Änderungsfelder sind title, description, h1 und body. Ordnen Sie zum Beispiel den title von https://example.com/about dem Titel Ihres eigenen Datensatzes „Über uns“ zu. Veröffentlicht wird getrennt, nachdem ein Mensch geprüft hat.
WordPress
Verbinden Sie die Website auf dem Bildschirm Connections. Bereiten Sie ein Anwendungspasswort für einen WordPress-Nutzer vor, der die betroffenen Beiträge und Seiten bearbeiten kann, und testen Sie es zuerst auf einer Testseite. Beschränken Sie es auf die nötige Bearbeitungsberechtigung und widerrufen Sie nicht mehr genutzte Passwörter. Schritt für Schritt mit Screenshots: WordPress verbinden.
Das Übernehmen auf einer veröffentlichten Seite aktualisiert den Live-Inhalt direkt. Aktionen wie Use this edit sind die Freigabe zum Schreiben. Ein separater Entwurf wird nicht unterstützt. Bei Page-Buildern und nicht bearbeitbaren Feldern kopieren Sie den Text und übernehmen ihn von Hand.
CMS-Entwurfsjobs
Für microCMS, Shopify, Webflow, Contentful und Sanity gibt es Beispiel-Entwurfsjobs, die bei Ihnen laufen. Sie benötigen Node.js 22.13 oder neuer und ein privates SQLite-Journal auf dauerhaftem Speicher. Übergeben Sie CMS-Geheimnisse als Umgebungsvariablen aus dem Secret-Speicher Ihres eigenen Servers und legen Sie sie nie in den Browser, in Konfigurationsdateien oder Logs. Get1pct speichert Ihre CMS-Geheimnisse nicht und führt diese Jobs nicht für Sie aus.
Es handelt sich vorerst um Testimplementierungen. Für alle fünf wurden das Speichern eines Entwurfs, das Zurücklesen und das Ergebnis einer Wiederholung in einer echten Umgebung bestätigt, mit unveröffentlichten Inhalten in eigenen Testumgebungen. Die Prüfungen gelten nur für diese Testobjekte. Bei Shopify wurde der Produktname geprüft; die SEO-Felder wurden nicht gegen die echte API getestet.
Das Beispiel unten ordnet eine URL und ein Get1pct-Feld einem microCMS-Endpunkt, einer Inhalts-ID und einem Feld zu. Ersetzen Sie die Werte passend zu Ihrer Testumgebung.
{
"projectId": "test-project-id",
"provider": "microcms",
"options": { "serviceId": "example-sandbox" },
"targets": [{
"page": "https://example.com/about",
"field": "title",
"target": {
"endpoint": "draft-fixtures", "id": "about", "field": "title",
"draftKeyEnv": "MICROCMS_DRAFT_KEY_ABOUT"
}
}]
}Die gemeinsamen Umgebungsvariablen sind GET1PCT_API_ORIGIN, GET1PCT_PROJECT_ID, GET1PCT_API_KEY, GET1PCT_CMS_CONFIG und GET1PCT_CMS_JOURNAL. Die Zugangsdaten für das jeweilige CMS gehören in die Variablen unten.
Shopify
Erstellen Sie eine App im Dev Dashboard und holen Sie sich mit dem Client-Credentials-Grant ein Server-Token. Verwenden Sie einen Entwicklungsshop, der nicht veröffentlicht, mit einem unveröffentlichten DRAFT-Produkt. Setzen Sie ein Token mit read_products und write_products in SHOPIFY_INTEGRATION_TOKEN und geben Sie shop (zum Beispiel example.myshopify.com) und productId (zum Beispiel gid://shopify/Product/123) an. title und description entsprechen den SEO-Feldern, h1 dem Produktnamen; Fließtext wird nicht unterstützt.
Webflow
Setzen Sie ein Token mit CMS-Lese- und Schreibzugriff für eine Testwebsite in WEBFLOW_INTEGRATION_TOKEN. Geben Sie ein bearbeitbares PlainText-Feld in der primären Sprache mit collectionId, itemId und fieldSlug an. Prüfen Sie, ob die Vorlage dieses Feld tatsächlich anzeigt. Änderungen werden im Staging gespeichert; veröffentlicht wird in einem eigenen Schritt.
Contentful
Setzen Sie in einem Testbereich und einer Testumgebung ein Management-API-Token, das den Zieleintrag lesen und bearbeiten kann, in CONTENTFUL_INTEGRATION_TOKEN. Geben Sie spaceId, environmentId, entryId, fieldId und locale (zum Beispiel en-US) an. Bestehende Textfelder werden unterstützt, Rich Text nicht. Änderungen an einem veröffentlichten Eintrag bleiben unveröffentlicht, bis Sie sie separat veröffentlichen.
Sanity
Setzen Sie in einem Test-Dataset ein Token, das den Zielentwurf lesen und bearbeiten kann, in SANITY_INTEGRATION_TOKEN. Geben Sie projectId, dataset, eine bestehende documentId, die mit drafts. beginnt, und ein Textfeld field an. Portable Text wird nicht unterstützt. Prüfen Sie den Inhalt im Studio und veröffentlichen Sie separat, wenn er live gehen soll.
microCMS
Bereiten Sie in einem Testdienst eine Listen-API und unveröffentlichte Inhalte vor und setzen Sie einen auf GET und PATCH dieser API beschränkten Schlüssel in MICROCMS_INTEGRATION_API_KEY. Legen Sie den draftKey des Entwurfs in die Umgebungsvariable, die draftKeyEnv in der Konfiguration nennt. Geben Sie serviceId, endpoint, id und ein Textfeld field an. Unterstützt werden nur bestehende unveröffentlichte Inhalte.
Testen und Betrieb
- Prüfen Sie mit Testdaten, ob URL, Feld und Wert „vorher“ übereinstimmen, und verarbeiten Sie dann genau eine freigegebene Änderung.
- Prüfen Sie Entwurfswert und Version in der CMS-Verwaltung und dass sich die Live-Seite nicht geändert hat. Direkte WordPress-Aktualisierungen testen Sie auf einer Testseite.
- Gehen Sie jeder Abweichung beim Wert „vorher“ und jedem Berechtigungsfehler nach. Wissen Sie nicht, ob ein Speichern geklappt hat, setzen Sie mit demselben Journal fort und lesen Sie zurück. Senden Sie nicht blind erneut und löschen Sie das Journal nicht.
Bei microCMS, Shopify und Webflow lassen sich gleichzeitige Bearbeitungen zwischen der letzten Prüfung und dem Speichern nicht vollständig verhindern. Achten Sie beim Testen darauf, dass keine andere Person und kein anderer Job denselben Datensatz bearbeitet.