Eine Einführung in die WordPress-REST-API

Veröffentlicht: 2017-01-13

Die Veröffentlichung von WordPress 4.7 hat in der Community für viel Aufregung gesorgt, und das aus gutem Grund. Neben den vielen eingeführten Verbesserungen und Funktionen war der eigentliche Show-Stealer die Ankündigung der REST-API-Core-Integration. Wie wir in früheren Beiträgen erwähnt haben, verwandelt dies WordPress effektiv von einer Blogging-Plattform in ein Content Management System (CMS). Aber wie wird diese Transformation stattfinden? Und was sind die Vorteile für die Benutzer?

In diesem Artikel stellen wir Ihnen zunächst einige grundlegende Konzepte vor und zeigen Ihnen dann, wie Sie mit der API und Ihrer Website herumspielen können.

Alle Websites unserer Kunden wurden bereits auf WordPress 4.7.1 aktualisiert. Fangen wir also an!

Was ist eine API?

API steht für Application Programming Interface . Es handelt sich um eine Reihe dokumentierter Strukturen, die einem Standard entsprechen und als LEGO-Blöcke für Softwareentwickler funktionieren. Diese Strukturen können Datenstrukturen, Funktionsaufrufe, Komponenten auf höherer Ebene, so ziemlich alles sein. Softwareentwickler verwenden APIs, um daraus komplexere Software zu erstellen. Sie werden häufig als Kommunikationsmethode zwischen verschiedenen Softwarekomponenten verwendet, unabhängig davon, ob sie lokal gehostet werden (denken Sie an Softwarebibliotheken) oder remote im Internet, wie dies bei REST-APIs der Fall ist.

Es gibt APIs für viele verschiedene Softwareebenen, vom Betriebssystem bis zum Web.

Was ist eine REST-API?

REST steht für REpresentational State Transfer und ermöglicht dieselbe Interoperabilität und Komponentenkommunikation, jedoch auf einer höheren Ebene: dem Web. Mit REST können Sie verschiedene webbasierte Software in Python, Java oder PHP schreiben lassen, die miteinander kommuniziert und Daten austauscht, selbst wenn sie auf verschiedenen Systemen gehostet werden. Da jedes System weiß, wie man REST „spricht“, kann es mit jedem sprechen, der dies tut!

REST verwendet das HTTP-Protokoll als Kommunikationstransport und die Standard-HTTP-Anforderungen, um seine grundlegenden Operationen zu implementieren. Diese Operationen werden Verben genannt. Die am häufigsten verwendeten sind: PUT, GET, PATCH, DELETE. Diese Verben wirken auf die Dinge, die REST als Ressourcen bezeichnet. Sie werden vom Softwareentwickler implementiert und implementieren effektiv alle vier grundlegenden Computeroperationen, die auf dem Speicher funktionieren: Erstellen, Lesen, Aktualisieren, Löschen ( CRUD ).

Hosten Sie Ihre Website mit Pressidium

60- TÄGIGE GELD-ZURÜCK-GARANTIE

SEHEN SIE UNSERE PLÄNE

Für die Datendarstellung und den Datenaustausch verwendet REST eine einfache Datenspezifikation namens JSON ( Javascript Object Notation ). Die Struktur von JSON ist sehr einfach. Seine Einfachheit und Benutzerfreundlichkeit im Vergleich zu den Tausend-Seiten-Spezifikationen von XML et al. brachten ihm die sofortige Übernahme durch Entwickler ein und machten es zum de-facto-Datenaustauschstandard des Webs.

Wie implementiert WordPress es?

Wir haben also das Konzept der Verben (Create, Read, Update, Delete), die auf Ressourcen wirken. WordPress definiert so ziemlich jede diskrete Information, die auf der Plattform vorhanden ist, als REST-Ressource. Von den Benutzern einer Website bis hin zu Einstellungen, Posts, Post-Taxonomien, Benachrichtigungen, Medien, Statistiken und allem dazwischen. Dazu gehören die Operationen, die für diese Ressourcen definiert werden können. Die für Kommentare definierten Operationen sind beispielsweise die folgenden:

  • Holen Sie sich eine Liste der letzten Kommentare.
  • Rufen Sie eine Liste der letzten Kommentare zu einem Beitrag ab.
  • Erhalten Sie einen einzelnen Kommentar.
  • Bearbeiten Sie einen Kommentar.
  • Erstellen Sie einen Kommentar zu einem Beitrag.
  • Erstellen Sie einen Kommentar als Antwort auf einen anderen Kommentar.
  • Löschen Sie einen Kommentar.
  • Holen Sie sich die Likes für einen Kommentar.
  • Wie ein Kommentar.
  • Entferne dein „Gefällt mir“ von einem Kommentar.
  • Holen Sie sich Ihren Like-Status für einen Kommentar.

Werfen Sie in aller Ruhe einen Blick auf die offizielle API-Dokumentationsseite für WordPress, um ein Gefühl für die Breite und Tiefe der API zu bekommen und zu sehen, was sie kann. Die Möglichkeiten sind so vielfältig!

WordPress wird somit zu einer Entwicklungsplattform und einem CMS , indem jedes darauf vorhandene Datenbit als REST-Ressource behandelt wird . Es stellt sie alle unter einer öffentlichen, standardisierten API bereit, die es externen Parteien ermöglicht, CRUD-Operationen an ihnen durchzuführen . Auf diese Weise öffnet sich WordPress und wird interoperabel mit dem Rest der Softwarewelt, sei es Java, Python oder Ruby; und so ziemlich mit jeder Sprache oder jedem System, das mit REST kommunizieren kann.

Probieren Sie es selbst aus

Es gibt mehrere Möglichkeiten, wie Sie anfangen können, an der REST-API Ihrer Website herumzubasteln. Am einfachsten ist es, ein REST-Test-Plugin in Ihrem Browser zu verwenden. Es gibt mehrere, aber der beliebteste ist Postman (verfügbar für MacOSX, Windows und Chrome).

Angenommen, Sie möchten ein JSON-Objekt abrufen, das alle Beiträge unseres Blogs enthält. Dazu müssen Sie zuerst die offizielle WordPress-REST-Referenz konsultieren, um die Basisroute dieses Anfrageaufrufs herauszufinden (es ist /wp/v2/posts ).

  Alles, was wir jetzt tun müssen, ist Folgendes:

  1. Wählen Sie GET aus dem Dropdown-Menü. Wie Sie sehen können, sind viele REST-Verben verfügbar, aber sie alle abzudecken, ist nicht Gegenstand dieses Artikels.
  2. Hängen Sie die Basisroute ( /wp/v2/posts ) an die REST-Stamm-URL Ihrer Website (http://www.acme_shop_2.onpressidium.com /wp-json/ ) an und bilden Sie die URL, die Sie auf dem Bildschirm sehen.
  3. Klicken Sie auf die Schaltfläche Senden .

Wenn alles gut geht, können Sie die JSON-Antwort Ihrer Website auf der Registerkarte Body darunter sehen. Sie können mit verschiedenen Basisrouten und Verben experimentieren, indem Sie die Dokumentation konsultieren. Die WordPress REST API ist etwas, mit dem wir uns in zukünftigen Beiträgen beschäftigen werden, in denen wir sie in eher entwicklerorientierten Artikeln ausgiebig nutzen werden.

Die Zukunft von WordPress ist rosig!

Im Laufe der Jahre hat sich WordPress stark weiterentwickelt und den Benutzern neue Möglichkeiten eröffnet. An alle, von einzelnen Bloggern, Journalisten, Verlegern bis hin zu Geschäftsinhabern und jetzt auch Softwareentwicklern aus anderen Open-Source-Communities. WordPress stärkt seine Benutzer weiterhin. Es ist weiterhin ein Beispiel dafür, was Menschen erreichen können, wenn sie von derselben Leidenschaft angetrieben werden und dennoch unterschiedliche Hintergründe haben. Seine REST-API-Integration in den WordPress-Kern eröffnet nicht nur eine neue Welt der Möglichkeiten, sondern schafft auch eine neue Welt der Komplexität . Das ist es, worum es bei unserer verwalteten WordPress-Hosting-Lösung wirklich geht, das ist unser Beitrag zur Community. Es geht darum, Sie und Ihr tägliches Unternehmen zu befähigen. Es geht darum, all diese Komplexität abzuwehren, alles am Laufen und Brummen zu halten und da zu sein, wenn die Dinge unweigerlich kaputt gehen.