Wie verbinde ich mein eigenes Website-System über Eigene API?

Wenn Ihre Website nicht auf WordPress, Shopify, Wix, Webflow oder Strapi läuft, aber eine eigene JSON-API für Beiträge hat, nutzen Sie Eigene API in den Projekteinstellungen. Fügen Sie die Adresse ein, die Ihre Beiträge auflistet, und gegebenenfalls ihr Token, klicken Sie auf API scannen, bestätigen Sie, in welches Ihrer Felder jeder Teil eines Beitrags kommt, und verbinden Sie dann. Es wird nichts geschrieben, bevor Sie die Zuordnung bestätigt haben.

Das Bild zeigt die englische Ansicht. Übersetzte Bilder folgen in Kürze.

Das ist meist eine Aufgabe für die Person, die Ihre Website gebaut hat.

#Was Ihre API braucht

• Eine Adresse, die Ihre Beiträge auflistet: eine GET-Anfrage, die JSON zurückgibt.
• Dieselbe Adresse muss neue Beiträge annehmen, und Beiträge müssen sich wieder entfernen lassen.
• Jeder Eintrag braucht eine ID. Ohne sie ließen sich Beiträge nie aktualisieren oder entfernen, daher ist das Verbinden dann gesperrt: Wir veröffentlichen nie dort, wo wir es nicht rückgängig machen können.
• Anmeldung per Token oder gar keine. Ein System, das sich nur über OAuth anmeldet, braucht stattdessen eine der eingebauten Verbindungen.

#So verbinden Sie

1. Klicken Sie auf dem Bildschirm Projekte auf das Zahnrad des Projekts, um die Projekteinstellungen zu öffnen.
2. Suchen Sie im Tab Verbindungen nach Eigene API und klicken Sie auf Verbinden.
3. Füllen Sie URL des Beitrags-Endpunkts aus, zum Beispiel https://ihre-website.de/api/posts.
4. Füllen Sie API-Token (leer lassen, wenn die API offen ist) aus.
5. Klicken Sie auf API scannen. Wir lesen einen Eintrag und sagen, wie viele wir gefunden haben und wie sich Ihre API anmeldet.
6. Prüfen Sie die vorgeschlagene Zuordnung. Wählen Sie für jeden Teil eines Beitrags (Seitentitel, Text, Auszug / Beschreibung und Slug), in welches Ihrer Felder er kommt, oder nicht gesendet, um ihn auszulassen. Ein Titel ist Pflicht; der Rest ist freiwillig. Jedes Feld zeigt ein Beispiel seines aktuellen Inhalts.
7. Klicken Sie auf Eigene API verbinden.

#Wie das Veröffentlichen über eine eigene API funktioniert

• Beiträge werden so angelegt, wie Ihre API sie anlegt. Es gibt keine Einstellung für Entwürfe; wenn Ihr System Entwürfe möchte, entscheidet es das selbst.
• Es gibt kein Zurückziehen. Um einen Beitrag offline zu nehmen, nutzen Sie Aus dem CMS entfernen, das den Eintrag löscht.
• Jede Veröffentlichung und jede Entfernung wird in der Veröffentlichungsaktivität protokolliert. Siehe Veröffentlichungsverbindungen und Aktivität.

Änderungen an Seitentiteln und Beschreibungen aus Inhalte, Seitentitel und Beschreibungen, Zu prüfende Änderungen bleiben bei einer eigenen API beim Kopieren und Einfügen.

#Häufige Fragen

#Der Scan sagt, die Einträge haben keine ID. Was nun?

Ihre API muss für jeden Beitrag eine ID zurückgeben, damit wir aktualisieren oder entfernen können, was wir veröffentlichen. Bitten Sie Ihren Entwickler, eine hinzuzufügen, und klicken Sie dann auf Erneut scannen.

#Es heißt „Diese API konnte nicht gelesen werden“. Was nun?

Prüfen Sie, ob die Adresse JSON zurückgibt, wenn sie mit dem Token aufgerufen wird, und ob das Token stimmt. Eine Adresse, für die Sie in einem Browser angemeldet sein müssen, funktioniert nicht.

#Kann ich die Zuordnung später ändern?

Klicken Sie auf Trennen, verbinden Sie dann erneut und wählen Sie die neue Zuordnung.

#Ist mein Token sicher?

Es wird verschlüsselt, bevor es gespeichert wird, und nie wieder angezeigt. Siehe Kontosicherheit.