Die WooCommerce REST API ermöglicht es, Produkte, Bestellungen und Kunden programmatisch von externen Anwendungen aus zu verwalten, etwa einer Buchhaltungssoftware, einer mobilen App oder einem individuellen Skript. In diesem Artikel erfährst du, wie du API-Schlüssel erstellst, wie die Authentifizierung funktioniert und wie du die ersten Anfragen ausführst, inklusive praktischer Stolperfallen und Sicherheitstipps.
Was ist die WooCommerce REST API
Die REST API von WooCommerce ist eine Schnittstelle, über die externe Software via HTTP-Anfragen mit deinem Webshop kommunizieren kann. Damit kannst du Produkte abrufen, Bestellungen anlegen, Lagerbestände aktualisieren oder Kundendaten synchronisieren, ohne dich im WordPress-Dashboard anzumelden. Das ist praktisch für Verbindungen mit Buchhaltungssoftware, Lagersystemen, Apps oder eigenen Dashboards.
Die API arbeitet auf Basis von Standard-HTTP-Methoden: GET zum Abrufen von Daten, POST zum Erstellen, PUT zum Ändern und DELETE zum Löschen. Antworten kommen im JSON-Format zurück, wodurch die Daten sich in nahezu jeder Programmiersprache einfach verarbeiten lassen.
API-Schlüssel erstellen
Bevor du die API nutzen kannst, musst du innerhalb von WooCommerce API-Schlüssel erstellen. Diese Schlüssel bestehen aus einem Consumer Key und einem Consumer Secret, vergleichbar mit einem Benutzernamen und einem Passwort.
Gehe zu den WooCommerce-Einstellungen
Melde dich in deinem WordPress-Dashboard an und gehe zu WooCommerce > Einstellungen > Erweitert > REST API.
Erstelle einen Schlüssel
Klicke auf „Schlüssel hinzufügen“, gib eine aussagekräftige Beschreibung an und verknüpfe den Schlüssel mit einem Benutzer mit ausreichenden Rechten.
Wähle die passenden Rechte
Lege fest, ob die Verbindung nur lesen, nur schreiben oder beides benötigt. Vergib nie mehr Rechte als notwendig.
Bewahre die Schlüssel sicher auf
Nach dem Generieren zeigt WooCommerce den Consumer Key und das Secret einmalig an. Speichere diese sofort sicher, zum Beispiel in einem Passwortmanager oder einer verschlüsselten Konfiguration.
Erste Anfragen ausführen
Sobald du die Schlüssel hast, kannst du Anfragen an den API-Endpunkt deines Webshops senden, zum Beispiel https://deinedomain.de/wp-json/wc/v3/products. Die Authentifizierung erfolgt über den Consumer Key und das Secret, meist als Query-Parameter oder über HTTP Basic Auth, wenn deine Website über HTTPS läuft.
Eine GET-Anfrage an den Produkte-Endpunkt liefert eine Liste von Produkten im JSON-Format zurück, inklusive Name, Preis, Lagerbestand und Bildern. Für das Anlegen einer Bestellung sendest du eine POST-Anfrage mit den Kundendaten und bestellten Produkten im JSON-Body. Die meisten Programmiersprachen bieten Bibliotheken, die dies vereinfachen, wie cURL in PHP oder das Requests-Modul in Python.
Teste neue Verbindungen zunächst in einer Testumgebung oder auf einer Staging-Site, bevor du sie im Live-Webshop nutzt, damit du während des Testens keine echten Bestellungen oder Kundendaten beeinflusst.
Sicherheit und Best Practices
Da die REST API Zugang zu sensiblen Daten bietet, ist es wichtig, stets über HTTPS zu arbeiten. Ohne gültiges SSL-Zertifikat werden Consumer Key und Secret unverschlüsselt übertragen, was ein Risiko darstellt. Achte also darauf, dass dein Webshop über ein aktives SSL-Zertifikat verfügt.
Beschränke außerdem die Rechte jedes Schlüssels auf das strikt Notwendige und entferne Schlüssel, die nicht mehr verwendet werden. Behalte den Überblick, welche externen Anwendungen Zugriff haben, und prüfe regelmäßig, ob dies noch aktuell ist. Kombiniere dies mit täglichen Backups deiner Umgebung, damit du bei einem fehlerhaften API-Aufruf schnell auf eine frühere Version zurücksetzen kannst.
Für stabile Leistung bei viel API-Verkehr empfiehlt es sich, auf einem Server mit ausreichender Kapazität und schnellem Speicher zu hosten. Beim Webhosting von Tandata läuft WooCommerce auf LiteSpeed-Servern mit NVMe-Speicher, und du findest die SSL-Einstellungen und Backup-Optionen einfach in Plesk. Hast du Fragen zur Konfiguration, kannst du in der Wissensdatenbank nachsehen oder den 24/7-Support kontaktieren.
Häufig gestellte Fragen
Ist die WooCommerce REST API standardmäßig aktiv?
Ja, die API ist standardmäßig verfügbar, sobald WooCommerce installiert ist. Du musst kein zusätzliches Plugin installieren, sondern nur Schlüssel erstellen.
Kann ich mehrere API-Schlüssel erstellen?
Ja, du kannst mehrere Schlüssel für verschiedene Verbindungen erstellen, jeweils mit eigenen Rechten. Das erleichtert die Verwaltung und den Entzug des Zugriffs pro Anwendung.
Funktioniert die API auch ohne SSL?
Technisch ja, aber davon wird dringend abgeraten, da Daten dann unverschlüsselt übertragen werden. Verwende für deinen Webshop stets ein gültiges SSL-Zertifikat.
Welche Daten kann ich über die API verwalten?
Du kannst unter anderem Produkte, Kategorien, Bestellungen, Kunden, Rabattcodes und Lagerbestände verwalten, abhängig von den Rechten, die du dem Schlüssel zuweist.
Was mache ich, wenn eine API-Anfrage eine Fehlermeldung ausgibt?
Prüfe zunächst, ob Consumer Key und Secret korrekt sind und ob der Benutzer ausreichende Rechte hat. Schau dir dann den Fehlercode in der JSON-Antwort an, dieser gibt meist an, was falsch ist.
Fazit
Die WooCommerce REST API bietet eine direkte und sichere Möglichkeit, deinen Webshop mit externen Systemen zu verbinden, sofern du Schlüssel sorgfältig verwaltest und stets über HTTPS arbeitest. Mit den richtigen Rechten, einer zuverlässigen Hosting-Umgebung und regelmäßiger Kontrolle bleiben deine Verbindungen stabil und sicher.