WordPress REST API für Anfänger: Greifen Sie von überall auf Ihre Inhalte zu

Die REST-API verwandelt WordPress in mehr als ein traditionelles Content-Management-System. Es wird zu einem Anwendungsframework.

Andere Programme – seien es mobile Apps, benutzerdefinierte Websites oder Dienste von Drittanbietern – können mit Ihrer WordPress-Site kommunizieren, Daten anfordern und sogar Inhalte ändern.

Sie denken vielleicht, das sei reines Entwicklergebiet. Das ist es nicht.

Die REST-API treibt Funktionen an, die Sie wahrscheinlich täglich nutzen. Der Block-Editor? Das ist die REST-API in Aktion. Jedes Mal, wenn Sie einen Block hinzufügen oder einen Beitragsentwurf speichern, tätigen Sie im Hintergrund API-Aufrufe.

In diesem Beitrag erkläre ich, was die WordPress REST API ist, was sie tatsächlich tut und wie Sie sie auf Ihrer Website verwalten.

Hier sind die wichtigsten Erkenntnisse:

• Die WordPress REST API ist in den WordPress-Core integriert und ermöglicht externen Anwendungen, Ihre Inhalte über einfache URLs zu lesen und zu ändern.
• Sie nutzen sie bereits; der Block-Editor ist für jeden Block, den Sie hinzufügen, und jeden Entwurf, den Sie speichern, auf die REST-API angewiesen.
• Sie ermöglicht Headless WordPress, mobile Apps und Single-Page-Anwendungen, indem sie Ihre Inhalte als JSON-Daten bereitstellt, die jede Plattform nutzen kann.
• Öffentliche Endpunkte (wie /wp-json/wp/v2/posts) funktionieren sofort, aber das Erstellen oder Bearbeiten von Inhalten erfordert eine Authentifizierung über Anwendungspasswörter.
• Die meisten REST-API-Probleme (404-Fehler, Authentifizierungsfehler) können durch erneutes Speichern Ihrer Permalinks oder Überprüfung Ihrer Anwendungspasswort-Konfiguration behoben werden.

Inhaltsverzeichnis

Was ist die WordPress REST API?

Die WordPress REST API ist eine integrierte Schnittstelle, die es anderen Systemen ermöglicht, mit Ihren WordPress-Daten zu interagieren. Stellen Sie sie sich als Brücke zwischen Ihrer WordPress-Site und der Außenwelt vor.

Sie ist Teil des WordPress-Cores. Sie müssen nichts Zusätzliches installieren; sie ist bereits vorhanden und wartet darauf, verwendet zu werden.

Die API verwendet JSON (JavaScript Object Notation) als Datenformat. JSON ist eine leichtgewichtige Methode, Daten als Text zu strukturieren. Es ist für Menschen lesbar, was bedeutet, dass Sie es tatsächlich ansehen und verstehen können, was Sie sehen.

Ein Blogbeitrag in JSON sieht aus wie eine übersichtliche Liste von Eigenschaften: Titel, Inhalt, Autor, Veröffentlichungsdatum und so weiter.

Warum das wichtig ist: Die REST-API ermöglicht „Entkopplung“. Sie können Ihre Inhalte in WordPress verwalten, diese Inhalte aber überall anzeigen. In einer mobilen App. Auf einer anderen Website. In einem digitalen Kiosk. In einer benutzerdefinierten Anwendung, die Ihr Team von Grund auf neu entwickelt hat.

Ihre Inhalte leben an einem Ort. Aber sie können überall erscheinen.

Was ist eine Application Programming Interface (API)?

Ich erkläre APIs gerne mit der Restaurant-Analogie, weil sie tatsächlich funktioniert.

Sie sitzen an einem Tisch. Sie möchten etwas essen. Aber Sie können nicht einfach in die Küche gehen und anfangen, Dinge aus dem Kühlschrank zu holen. Sie brauchen einen Vermittler: das ist der Kellner.

Sie sagen dem Kellner Ihre Bestellung (Ihre Anfrage). Der Kellner bringt sie in die Küche (den Server/die Datenbank). Die Küche bereitet Ihr Essen zu. Der Kellner bringt es Ihnen zurück (die Antwort).

Eine API ist der Kellner. Sie ist das Bindeglied zwischen einer Anwendung, die Daten möchte, und dem System, das diese Daten hat. Die API nimmt Anfragen entgegen, kommuniziert mit den richtigen Systemen und liefert die Ergebnisse in einem Format, das die anfragende Anwendung verstehen kann.

Ohne die API bräuchten Anwendungen direkten Zugriff auf Ihre Datenbank. Das wäre unübersichtlich, unsicher und in großem Maßstab kaum zu verwalten.

Was ist Representational State Transfer (REST)?

REST ist eine Reihe von architektonischen Regeln für den Aufbau von APIs. Wenn eine API diesen Regeln folgt, nennen wir sie „RESTful“. Die WordPress REST API folgt diesen Prinzipien, weshalb sie „REST“ im Namen trägt.

Hier sind die Kernkonzepte:

Zustandslos

Der Server erinnert sich nicht an frühere Anfragen. Jede Anfrage, die Sie stellen, muss alles enthalten, was der Server zur Bearbeitung benötigt. Sie können nicht davon ausgehen, dass der Server weiß, was Sie vor fünf Sekunden angefordert haben.

Das klingt einschränkend, aber es ist tatsächlich das, was REST-APIs skalierbar macht. Der Server verschwendet keine Ressourcen damit, Sitzungszustände für Tausende gleichzeitiger Anfragen zu verfolgen.

Client-Server

Der Client (die App, die Anfragen stellt) und der Server (Ihre WordPress-Site) sind vollständig getrennt. Sie können unabhängig voneinander entwickelt werden. Ihre React-App kümmert sich nicht darum, ob WordPress auf Version 6.5 oder 7.0 aktualisiert wird, solange die API-Endpunkte konsistent bleiben.

Einheitliche Schnittstelle

REST-APIs verwenden Standard-HTTP-Methoden wie GET, POST, PUT und DELETE. Diese Standardisierung macht die API vorhersehbar. Entwickler, die mit REST vertraut sind, können die WordPress-API schnell verstehen, da sie Konventionen folgt, die sie bereits kennen.

Diese Prinzipien sind nicht nur akademisch. Sie machen die WordPress REST API zuverlässig, vorhersehbar und einfach zu handhaben.

Was macht die WordPress REST API?

Die REST-API stellt Ihre WordPress-Daten über URLs bereit, die als „Endpunkte“ bezeichnet werden. Ein Endpunkt ist eine bestimmte Adresse, an der Sie bestimmte Daten abfragen können.

Zum Beispiel: /wp-json/wp/v2/posts ist der Endpunkt für Ihre Blogbeiträge. Besuchen Sie diese URL auf Ihrer Website, und Sie erhalten eine JSON-Antwort, die Ihre Beiträge enthält – Titel, Inhalt, Autoren, Beitragsbilder, alles.

Dies ist die Technologie, die den Block-Editor antreibt. Wenn Sie in Gutenberg arbeiten, löst jede Aktion, die Sie ausführen, einen API-Aufruf aus.

Einen Absatzblock hinzufügen? API-Aufruf. Ein Bild hochladen? API-Aufruf. Ihren Entwurf speichern? API-Aufruf. Die Editor-Oberfläche ist im Wesentlichen eine JavaScript-Anwendung, die über die REST-API mit Ihrer WordPress-Site kommuniziert.

Die API ermöglicht programmatische CRUD-Operationen (Create, Read, Update und Delete). Sie können all diese Aktionen mit Ihren Inhalten durchführen, ohne jemals das WordPress-Dashboard zu öffnen.

Als Entwickler könnten Sie ein Skript schreiben, das 100 Beiträge in fünf Sekunden erstellt. Oder alle Ihre Beiträge vom letzten Monat abrufen und einen Bericht erstellen. Oder jeden Beitrag mit dem Tag „veraltet“ mit einem Haftungsausschluss-Banner aktualisieren.

Die Möglichkeiten erweitern sich dramatisch, sobald Sie erkennen, dass WordPress nicht mehr nur eine Website ist – es ist eine Content-API, die zufällig auch Websites rendert.

Gängige REST-API-Befehle

Die REST-API verwendet Standard-HTTP-Methoden, um verschiedene Aktionen auszuführen. Hier ist, was jede einzelne tut:

HTTP-Methode	Aktion	Beispiel
GET	Daten vom Server abrufen	Liste aller veröffentlichten Beiträge abrufen
POST	Neue Daten erstellen	Einen neuen Blogbeitrag oder eine neue Seite hinzufügen
PUT / PATCH	Bestehende Daten aktualisieren	Den Titel eines bestehenden Beitrags bearbeiten
DELETE	Daten entfernen	Einen Kommentar oder eine Mediendatei löschen

GET-Anfragen sind schreibgeschützt. Jeder kann sie stellen, da sie Ihre Daten nicht ändern. Wenn Sie einen öffentlichen Endpunkt in Ihrem Browser aufrufen, stellen Sie eine GET-Anfrage.

Die anderen Methoden ändern Ihre Daten. Sie erfordern eine Authentifizierung. WordPress muss überprüfen, ob Sie die Berechtigung zum Erstellen, Aktualisieren oder Löschen von Inhalten haben, bevor diese Anfragen verarbeitet werden.

Wie greife ich auf die WordPress REST API zu?

Die REST-API ist auf jeder WordPress-Site mit Version 4.7 oder höher standardmäßig aktiviert. Der Basispfad ist /wp-json/.

Sie können dies sofort testen.

Öffnen Sie einen neuen Tab in Ihrem Browser und navigieren Sie zu IhreDomain.com/wp-json/. Sie sehen eine JSON-Antwort, die alle verfügbaren API-Routen auflistet. Es ist nicht schön, aber es bestätigt, dass Ihre API funktioniert.

Möchten Sie Ihre Beiträge sehen? Versuchen Sie es mit IhreDomain.com/wp-json/wp/v2/posts. Sie erhalten ein JSON-Array Ihrer veröffentlichten Beiträge, komplett mit allen Metadaten.

Diese öffentlichen Endpunkte zeigen nur Daten an, die auf Ihrer Website bereits öffentlich sichtbar sind. Aber was ist mit Aktionen, die Daten ändern, wie das Erstellen von Beiträgen, das Aktualisieren von Seiten oder das Löschen von Kommentaren?

Diese erfordern eine Authentifizierung.

WordPress unterstützt zwei Hauptauthentifizierungsmethoden. Cookie-Authentifizierung funktioniert für Anfragen von derselben Domain (wie der Block-Editor).

Für externe Anwendungen verwenden Sie Anwendungspasswörter. Dies sind 24-stellige Token, die Sie in WordPress generieren und die speziell für den API-Zugriff entwickelt wurden. Sie sind sicherer als Ihr tatsächliches Passwort, da Sie sie einzeln widerrufen können, ohne Ihre Hauptanmeldedaten zu ändern.

Um eines zu generieren, gehen Sie zu Benutzer » Profil. Suchen Sie die Einstellungen für Anwendungspasswörter und erstellen Sie ein neues.

Greifen Sie dann mit diesem auf die REST-API zu:

https://mysite.com/wp-json/wp/v2/posts?Authorization=Bearer[Password]

Ersetzen Sie [Passwort] durch Ihr Anwendungspasswort und entfernen Sie alle Leerzeichen.

Alternativ können Sie ein Plugin wie JWT Authentication for WP REST API verwenden.

Anwendungspasswörter sind die bevorzugte Methode. Sie sind sicher, nachvollziehbar und setzen Ihr echtes Passwort keinen Drittanbieteranwendungen aus.

Um die Verbindung zu testen, verwenden Sie diesen Befehl in einer Kommandozeile:

curl -X GET --user benutzername:passwort -i http://ihreseite.com/wp-json/wp/v2/posts?status=draft

Verwendung der WordPress REST API: Häufige Anwendungsfälle

Nachdem Sie nun verstehen, was die REST-API ist und wie sie funktioniert, betrachten wir praktische Szenarien, in denen ihre Verwendung sinnvoll ist.

Headless WordPress

Dies ist, wenn Sie WordPress ausschließlich als Content-Management-Backend verwenden. Ihre Besucher sehen niemals ein WordPress-Theme. Stattdessen erstellen Sie ein benutzerdefiniertes Frontend mit einem JavaScript-Framework wie React, Vue oder Next.js.

Dieses Frontend ruft Inhalte über die WordPress REST API ab und rendert sie nach Belieben. Sie erhalten die hervorragenden Content-Management-Tools von WordPress, gepaart mit völliger Gestaltungsfreiheit im Frontend.

Mobile Apps

Sie können eine native iOS- oder Android-App vollständig mit Inhalten von Ihrer WordPress-Website betreiben. Die App macht API-Anfragen, um Beiträge abzurufen, Bilder anzuzeigen und Kommentare darzustellen.

Ihr Content-Team verwaltet alles über das WordPress-Dashboard, das es bereits kennt. Die App-Entwickler berühren das CMS nie.

Single Page Applications (SPAs)

Dies sind Webanwendungen, die einmal geladen werden und dann dynamisch neue Inhalte ohne vollständiges Neuladen der Seite abrufen. Die Benutzererfahrung fühlt sich schneller und app-ähnlicher an.

Gmail funktioniert auf diese Weise. Wenn Sie zwischen E-Mails wechseln, wird die Seite nicht neu geladen – JavaScript ruft den E-Mail-Inhalt über eine API ab. Sie können die gleiche Erfahrung mit WordPress-Inhalten erstellen.

Datensynchronisation

Daten aus WordPress in eine andere Plattform ziehen oder Daten von einem externen Dienst in WordPress pushen.

Ich habe dies gesehen, um Produktinformationen zwischen WordPress und Bestandsverwaltungssystemen zu synchronisieren. Oder um automatisch WordPress-Beiträge aus Daten zu erstellen, die in einem CRM gesammelt wurden.

Die REST API ermöglicht diese Integrationen ohne komplexe Datenbankmanipulation.

Wann sollte die REST API nicht verwendet werden?

Wenn Sie einen geradlinigen Blog oder eine Geschäftswebsite betreiben, müssen Sie wahrscheinlich nicht direkt mit der REST API interagieren. Ein traditionelles WordPress-Theme erledigt alles perfekt.

Wenn die anfängliche Ladezeit der Seite Ihre absolute Priorität hat, ist ein serverseitig gerendertes Theme oft schneller.

Headless-Setups erfordern JavaScript zum Abrufen und Rendern von Inhalten, was zu Latenz führt. Für inhaltsreiche Websites, bei denen jede Millisekunde Ladezeit zählt, ist die traditionelle WordPress-Architektur möglicherweise besser geeignet.

Wenn ein zuverlässiges, gut unterstütztes Plugin Ihr Integrationsproblem bereits löst, verwenden Sie das Plugin. Erstellen Sie keine benutzerdefinierte REST API-Lösung nur, weil Sie es können.

Plugins werden gewartet, getestet und aktualisiert. Eine benutzerdefinierte Integration ist technische Schuld, die Sie verwalten müssen.

Die REST API ist leistungsstark. Aber Macht ohne Zweck schafft unnötige Komplexität.

Wie deaktiviere ich die WordPress REST API?

Ich muss mit einer Warnung beginnen: Das vollständige Deaktivieren der REST API bricht den Block-Editor. Es wird wahrscheinlich auch mehrere Plugins brechen. Wenn Sie sie vollständig deaktivieren und sich dann fragen, warum Gutenberg nicht mehr funktioniert, ist das der Grund.

Der bessere Ansatz ist die Einschränkung, nicht die Deaktivierung. Sie können die Authentifizierung für alle API-Endpunkte erzwingen. Dies hält den Block-Editor für angemeldete Benutzer funktionsfähig und blockiert gleichzeitig den anonymen Zugriff auf öffentliche Endpunkte.

Wenn Sie die REST API definitiv deaktivieren möchten, empfehle ich die Verwendung eines Plugins wie WPCode. Es verfügt über einen integrierten Code-Snippet, der diese Aufgabe für Sie erledigt.

Wählen Sie das Code-Snippet aus und fügen Sie es automatisch in Ihre Website ein. Aktivieren und aktualisieren Sie das Snippet, um Ihre Änderungen zu speichern.

Häufige REST-API-Probleme beheben

Selbst wenn die REST-API aktiviert und funktionsfähig ist, werden Sie gelegentlich auf Probleme stoßen. Hier sind die häufigsten Probleme, auf die ich gestoßen bin, und wie man sie behebt.

404 Nicht gefunden

Dies ist der Fehler, den ich am häufigsten sehe. Sie versuchen, auf einen API-Endpunkt zuzugreifen, und WordPress gibt eine 404 zurück, als ob die Seite nicht existiert.

In neun von zehn Fällen handelt es sich um ein Problem mit den Permalinks. WordPress verwendet .htaccess-Regeln (auf Apache-Servern), um API-Anfragen korrekt weiterzuleiten. Manchmal werden diese Regeln beschädigt oder nicht richtig neu generiert nach einer Migration oder Serveränderung.

Gehen Sie in Ihrem WordPress-Dashboard zu Einstellungen » Permalinks. Ändern Sie nichts. Klicken Sie einfach auf Änderungen speichern. WordPress generiert die Rewrite-Regeln neu, und Ihre API funktioniert wieder.

401 oder 403 Authentifizierungsfehler

Eine 401 bedeutet „nicht autorisiert“ – Sie haben keine Anmeldeinformationen angegeben. Eine 403 bedeutet „verboten“ – Sie haben Anmeldeinformationen angegeben, aber diese haben keine Berechtigung für diese Aktion.

Stellen Sie sicher, dass Ihr Anwendungspasswort korrekt eingegeben ist (keine Leerzeichen, korrekter Benutzername). Überprüfen Sie, ob das Benutzerkonto die richtigen Berechtigungen für das hat, was Sie versuchen zu tun.

Plugin- oder Theme-Konflikte

Manchmal stört ein schlecht codiertes Plugin oder Theme die Funktionalität der REST-API. Verwenden Sie den Standard-Troubleshooting-Prozess von WordPress: Deaktivieren Sie alle Plugins, wechseln Sie zu einem Standard-Theme (wie Twenty Twenty-Four) und testen Sie die API.

Wenn es funktioniert, aktivieren Sie die Plugins einzeln wieder, bis Sie den Schuldigen gefunden haben. Kontaktieren Sie dann den Entwickler dieses Plugins oder finden Sie eine Alternative.

CORS-Fehler

Diese erscheinen in der Konsole Ihres Browsers, wenn eine Webanwendung auf einer Domain versucht, auf die API auf einer anderen Domain zuzugreifen. CORS (Cross-Origin Resource Sharing) ist eine Sicherheitsfunktion des Browsers. Sie blockiert diese Anfragen standardmäßig.

Die Behebung erfordert das Hinzufügen spezifischer HTTP-Header auf Ihrem WordPress-Server, die Anfragen von der Domain Ihrer Anwendung explizit zulassen. Dies beinhaltet typischerweise die Bearbeitung Ihrer .htaccess-Datei oder die Konfiguration von Headern in Ihrem Hosting-Kontrollpanel.

Wenn Sie CORS-Fehler sehen, arbeiten Sie mit einem Headless- oder entkoppelten Setup, und Sie benötigen Server-Zugriff, um diese zu beheben.

Häufig gestellte Fragen (FAQs)

Die Zukunft ist vernetzt

Die WordPress REST API verwandelt WordPress von einem traditionellen Content-Management-System in ein echtes Anwendungs-Framework. Es geht nicht mehr nur darum, Websites zu erstellen – es geht darum, Ihre Inhalte überall verfügbar zu machen, wo Sie sie benötigen.

Diese API ist die Brücke. Sie verbindet WordPress mit modernen Webanwendungen, mobilen Apps und Drittanbieterdiensten. Wenn Sie verstehen, wie sie funktioniert, können Sie bessere Entscheidungen über die Architektur Ihrer Website treffen, Probleme schneller beheben und effektiver mit Entwicklern kommunizieren.

Die Daten Ihrer WordPress-Website sind die treibende Kraft für alles, von den Seiten, die Ihre Besucher sehen, bis zu den Inhalten, die Ihre REST API für andere Anwendungen bereitstellt. Der Schutz dieser Daten ist nicht verhandelbar.

Duplicator Pro bietet Ihnen eine zuverlässige Möglichkeit, Ihre gesamte WordPress-Installation zu sichern. Bevor Sie mit einem Headless-Setup experimentieren oder eine neue App verbinden, führen Sie ein vollständiges Backup durch. Mit Duplicator Pro können Sie automatische Backups planen und beruhigt sein, da Sie wissen, dass Ihre wertvollen Inhalte sicher sind.

Während Sie hier sind, denken wir, dass Ihnen diese anderen handverlesenen WordPress-Ressourcen gefallen werden:

• So installieren Sie WordPress über SSH wie ein Profi
• WordPress CSS lernen: Einfache Techniken, die ich mir vom ersten Tag an gewünscht hätte
• WordPress ist Drag & Drop, aber hier ist der Grund, warum ich immer noch mit HTML herumspiele
• Verwandeln Sie Ihre Website von statisch zu dynamisch mit WordPress JavaScript
• Wie lange dauert es, WordPress im Jahr 2025 zu lernen?
• So verwenden Sie die WordPress CLI: Beherrschen Sie die Kommandozeile