Dieselben Operationen
Was Sie am Bildschirm tun, tun Sie per Aufruf: Websites, Inhalte, Bilder, Themes, Menüs, Weiterleitungen, Veröffentlichung, Search Console. Die Dokumentation führt jede Operation einzeln auf.
Entwickler
Joornal lässt sich über die API steuern
Alles, was das Back-Office tut, geht auch über die API: eine Website anlegen, Inhalte importieren, veröffentlichen, Search-Console-Daten lesen. Mit Ihren Werkzeugen, in Ihren Abläufen, mit denselben Berechtigungen wie Ihre Nutzer.
Dasselbe wie die Oberfläche, ohne die Oberfläche
Diese API ist kein widerwillig zugestandener Ausschnitt. Es ist dieselbe Anwendung, von der anderen Seite betrachtet.
Dieselben Berechtigungen
Ein Token reicht nur so weit wie der Bereich seines Inhabers: sein Kunde, seine Projekte, seine Websites. Eine Ressource außerhalb davon antwortet 403. Es gibt kein getrenntes „API-Konto“ mit eigenen Regeln, die man nachpflegen müsste.
Keine Sitzung, kein Cookie
Ein X-API-TOKEN-Header pro Aufruf, jedes Mal geprüft. Nichts zu öffnen, nichts zu erneuern, nichts im Browser abzulegen.
Fehler, die sich gleichen
Ein einziger Fehlervertrag für die gesamte API: ein stabiler maschinenlesbarer Code, eine verständliche Meldung und die Details Feld für Feld, wenn eine Validierung fehlschlägt. Sie schreiben die Fehlerbehandlung einmal.
Was Sie steuern
Die Anwendungsfälle, die bei Agenturen und Mehrmarkengruppen am häufigsten vorkommen.
Aus Ihren eigenen Systemen befüllen
Massenimport von Inhalten, idempotent: derselbe Aufruf erneut ausgeführt erzeugt kein Duplikat, und Sie entscheiden, ob er Vorhandenes unberührt lässt oder aktualisiert. Sie können rückdatieren, eine Veröffentlichung planen, Kategorien und Signaturen zuordnen und die Bilder im selben Zug mitschicken.
Eine bestehende Website übernehmen
Übernahme aus WordPress oder aus einem Export, dann der Livegang: Theme, Domain, Weiterleitungen, Sitemap. Der Bestand wird per Aufruf angelegt und konfiguriert, nicht per Ticket.
Zum richtigen Zeitpunkt veröffentlichen
Eine Veröffentlichung auslösen, eine Artikelwarteschlange neu planen, den Fortschritt verfolgen. Lange Operationen liefern eine Vorgangs-ID zurück, die Sie bis zum Ende abfragen.
Die Daten zurückholen
Search-Console-Leistung pro Artikel, Indexierungsstand URL für URL, Statistiken zu Crawler-Zugriffen, Kontaktanfragen aus dem Formular. Um Ihre eigenen Auswertungen zu speisen, statt sie abzutippen.
Worauf Sie sich verlassen können
Eine API, die man anbindet, ist eine API, deren Regeln man vorher kennt. Unsere stehen in der Dokumentation, nicht in einem Vertrag, den man anfordern muss.
Ein Jahr nach der Abkündigung
Ein Feld oder eine Operation, die entfallen sollen, werden zuerst in der Spezifikation markiert, mit ihrem Nachfolger und dem Datum der Markierung. Sie werden ab diesem Datum noch mindestens ein Jahr ausgeliefert. Sie haben immer ein volles Jahr für die Umstellung.
Eine Spezifikation, die nicht lügt
Die OpenAPI-Spezifikation ist öffentlich, und unsere Continuous Integration weist jede Änderung der API zurück, der die Aktualisierung der Dokumentation fehlt. Die Dokumentation kann nicht stillschweigend veralten: sie zeigt das Datum ihrer letzten Überprüfung.
Angekündigte Grenzen
Jede Antwort trägt das Kontingent, das Ihnen bleibt. Sie müssen eine Grenze nie dadurch entdecken, dass Sie gegen sie laufen, und können langsamer werden, bevor sie Sie stoppt.
Ein unbekannter Filter wird abgelehnt
Ein falsch geschriebener oder abgeschaffter Parameter erzeugt einen Fehler, nie ein Ergebnis, das bloß richtig aussieht. Das ist die Art Detail, die man erst an dem Tag bemerkt, an dem sie eine Woche gekostet hat.
Holen Sie sich die Kontrolle über Ihre Sichtbarkeit zurück
Vereinbaren Sie eine individuelle Demo und sehen Sie, wie ein strukturiertes, leistungsfähiges und datengesteuertes Medium entsteht.