Lukas G.Hinweis: Der folgende Artikel hilft Ihnen dabei: So verwenden Sie die WooCommerce-API
WordPress ist derzeit das beliebteste CMS. Warum? Weil es sich problemlos in Tausende von Tools integrieren lässt, um die Leistung und Funktionalität Ihrer Website zu verbessern.
Diese Tools decken ein breites Spektrum an Branchen ab, aber die Benutzer sind immer wieder beeindruckt von der Menge der für den E-Commerce verfügbaren Tools. Eines der leistungsstärksten E-Commerce-Tools ist die WooCommerce API.
Die WooCommerce-API verstehen
Die API von WooCommerce besteht aus drei Hauptkomponenten. Um zu verstehen, wie leistungsstark diese API sein kann, schauen wir uns jede Komponente einzeln an.
REST-API
Mit der REST-API von WooCommerce können Benutzer von außerhalb ihrer Website auf ihre WooCommerce-Storefront zugreifen. Dieses Design ermöglicht Ihnen den Zugriff auf Ihren Shop über andere Internetanwendungen wie beispielsweise Shopify.
Letztendlich erleichtert die REST-API die Verwaltung Ihres Shops. Sie können über die Dashboards anderer Apps auf Ihren WooCommerce-Shop zugreifen und haben dennoch Zugriff auf die vollständige WooCommerce-Administratorfunktion.
Legacy-API
Durch die Aktivierung der Legacy-API haben Sie früher Ihre API für WooCommerce aktiviert. Dieser Teil des Prozesses ist jedoch in neueren Versionen veraltet.
Die neueste Version ist die WooCommerce REST API. Es lässt sich direkt in die WordPress-API integrieren. Die Legacy API ist die ältere Version von WooCommerce. Benutzer sollten ihre Einstellungen noch einmal überprüfen, da WooCommerce dazu neigt, standardmäßig die Legacy-API zu starten.
Webhooks
Webhooks ermöglichen es WooCommerce, andere Apps anzurufen. Wenn Sie beispielsweise möchten, dass Aktionen innerhalb von WooCommerce durch Aktionen in anderen Apps ausgelöst werden, können Sie einen Webhook verwenden.
Die API erreicht dies mithilfe von URLs. Sie können eine Benachrichtigung über die API an eine bestimmte URL senden. Diese URLs können Ereignisse auf einer bestimmten Site auslösen und eine andere Aktion auf einer separaten Site oder Seite auslösen.
Verkaufen Sie Ihre Produkte sorgenfrei online
Unser von WooCommerce offiziell empfohlenes Hosting ist für Online-Unternehmen wie Ihres konzipiert
Wichtige WooCommerce-API-Terminologie
Wenn Sie die API-Dokumentation von WooCommerce durchgehen, werden Sie auf einige für WooCommerce einzigartige Terminologien stoßen. Sehen wir uns diese Begriffe und Definitionen an, um Sie bei Ihrem API-Prozess zu unterstützen.
Anfrage-/Antwortformat
Dies gibt an, welches Format WooCommerce zur Übertragung bestimmter Datentypen verwendet. Es ist wichtig, sich der unterschiedlichen Datentypen bewusst zu sein, da bestimmte URLs und Trigger nicht funktionieren, wenn sie die Daten nicht im richtigen Format empfangen.
Das Standardformat für die meisten Daten innerhalb der WooCommerce-API ist JSON. Kalenderdaten werden als Ganzzahlen zurückgegeben, und jede Zahl (wie Geld, Preis oder Gesamtsummen) wird in einer Textzeichenfolge angezeigt und standardmäßig auf zwei Dezimalstellen gesetzt. Alles, was leer bleibt, wird als leere Zeichenfolge oder „null“ zurückgegeben.
Authentifizierung
Der Authentifizierungsprozess ermöglicht die WooCommerce-API-Integration. Benutzer können die API mithilfe von API-Schlüsseln mit anderen Plattformen verbinden.
Um einen WooCommerce-API-Schlüssel zu generieren, müssen Sie auf Ihre Einstellungen zugreifen. Für WooCommerce-Benutzer stehen zwei Schlüssel zur Verfügung: ein Secret Key und ein Consumer Key.
Verbraucherschlüssel werden auch als allgemeine oder API-Schlüssel bezeichnet. Diese Schlüssel werden einem Benutzer von verschiedenen Plattformen aus ausgegeben. Mit WooCommerce-API-Schlüsseln können Sie eine Verbindung zu anderen Plattformen wie WordPress, Shopify usw. herstellen.
Der Secret Key verhält sich für bestimmte Apps und Plattformen ähnlich. Wenn Sie Tools oder Apps von Drittanbietern mit WooCommerce verbinden, fungiert der General- oder Consumer-Schlüssel als „Benutzername“ Ihrer Anmeldeinformationen, während der Secret Key als Ihr Passwort fungiert.
Endpunkte
In Bezug auf die API-Technologie ist ein Endpunkt der Punkt, an dem die API mit einer anderen App oder Plattform interagiert. Ein Beispiel für einen Endpunkt wäre die URL für eine bestimmte Plattform, wie Shopify oder Facebook.
Einrichten der WooCommerce-API
Das Einrichten Ihrer WooCommerce-API ist relativ einfach. Befolgen Sie die folgenden Schritte, um alle Ihre Tools mit der Plattform zu verknüpfen und das E-Commerce-Einkaufserlebnis Ihrer Kunden zu verändern.
Sie müssen durch die folgenden Menüs in Ihrem WordPress-Dashboard navigieren:
WooCommerce > Einstellungen > Erweitert > Legacy-API
Es gibt ein Kontrollkästchen, um anzugeben, ob die API aktiviert ist oder nicht. Stellen Sie sicher, dass das Kontrollkästchen aktiviert ist, klicken Sie auf „Änderungen speichern“ und der API-Zugriff ist jetzt verfügbar.
So erstellen Sie API-Schlüssel in WooCommerce
API-Schlüssel sind das Rückgrat der WooCommerce-API-Funktionen. Es ist an der Zeit, einige zu erstellen, um Ihre bevorzugten Tools und Plattformen zu verbinden. Befolgen Sie dazu die folgenden Schritte.
1. Schlüssel hinzufügen
Sie müssen für jede App oder Plattform, die Sie mit WooCommerce verbinden, einen neuen Schlüssel erstellen. Die API generiert für jede neue Verbindung, die Sie erstellen, einen Verbraucherschlüssel und einen geheimen Schlüssel.
Sie müssen zum REST-API-Menü gehen, um einen Schlüssel hinzuzufügen. So finden Sie es:
WooCommerce > Einstellungen > Erweitert > REST API
Sobald Sie dort sind, klicken Sie Schlüssel hinzufügen.
2. Konfigurieren Sie die wichtigsten Einstellungen
Sobald Sie auf „Schlüssel hinzufügen“ klicken, müssen Sie einige Entscheidungen treffen. Für jeden Schlüssel, den Sie erstellen, müssen Sie die folgenden Einstellungen konfigurieren:
- Beschreibung – Hier können Sie jeden Schlüssel für die entsprechende Plattform „benennen“, um ihn besser organisieren zu können
- Eigentümer – Weisen Sie einen Schlüssel dem dafür zuständigen Benutzer in Ihrem Team zu
- Berechtigungen – Diese bestimmen, welche Funktionen Sie diesem bestimmten Schlüssel gewähren. Wenn Sie beispielsweise einen bestimmten Schlüssel zum Löschen oder Anpassen von Daten benötigen, müssen Sie „Lese-/Schreibberechtigungen“ erteilen.
3. API-Generierung
Sobald die Konfiguration Ihrer Einstellungen abgeschlossen ist, klicken Sie unten auf dem Bildschirm auf die Schaltfläche „Schlüssel generieren“. Die nächste Seite, zu der Sie weitergeleitet werden, enthält einen Verbraucherschlüssel und einen geheimen Schlüssel sowie einen QR-Code für diese Verbindung.
Sobald Sie die Seite zur API-Generierung verlassen, können Sie nicht mehr zurückkehren. Kopieren Sie diese Schlüssel also in ein anderes Word- oder Notes-Dokument und behalten Sie sie bei. Sie benötigen sie, um eine Verbindung zu Ihrem WooCommerce-Setup herzustellen.
4. Verwenden von Tasten zum Herstellen einer Verbindung mit Apps von Drittanbietern
Nachdem Ihre API-Schlüssel generiert wurden, können wir nun mit der Verbindung zu Apps und Plattformen von Drittanbietern, sogenannten „API-Clients“, beginnen. Sie müssen die Schritte auf beiden Seiten der Verbindung im WooCommerce-Menü in WordPress und der von Ihnen gewählten App befolgen.
Jede Plattform ist anders, daher müssen Sie auf die Hilferessourcen der jeweiligen Plattform zugreifen. Suchen Sie nach Tipps zum Zugriff auf die Autorisierungsdaten der App.
Die meisten Plattformen bieten mehrere Autorisierungsarten an. Sie möchten „Basisautorisierung“ auswählen.
Kopieren Sie Ihren allgemeinen oder Verbraucher-API-Schlüssel, fügen Sie ihn in die Leiste „Benutzername“ ein und verwenden Sie Ihren geheimen Schlüssel als Passwort. Dadurch haben Sie WooCommerce erfolgreich mit einem Ihrer anderen leistungsstarken E-Commerce-Tools verbunden. Der nächste Schritt besteht darin, mit der Erstellung von API-Anfragen zu beginnen.
So stellen Sie WooCommerce-API-Anfragen
Bei API-Anfragen geschieht die Magie. Diese Anfragen ermöglichen alle „coolen“ Funktionen, die Ihnen das Leben erleichtern. Diese Anfragen kommen in zwei Formaten – GET oder PUT. Führen Sie die folgenden Schritte aus, um sie zwischen den Tools zu konfigurieren.
1. Testen Sie eine GET-Anfrage
GET-Anfragen sind, wie der Name schon sagt, hilfreich beim Abrufen von Daten aus anderen Quellen. Ein praktisches E-Commerce-Beispiel wäre das Erstellen einer Liste Ihrer WooCommerce-Produkte. Dies erfordert etwas technisches Geschick, aber wenn Sie die Anweisungen befolgen, sollte alles in Ordnung sein.
Um diese GET-Funktion auszuführen, müssen Sie die folgende URL eingeben:
https://yoursite.com/wp-json/wc/v3/products
Natürlich möchten Sie Ihre URL dort eingeben, wo „Ihre Website“ steht. Bei der Ausführung ruft dieser GET alle Daten für Ihre in WooCommerce gelisteten Produkte ab.
Die WooCommerce-API-Integration gibt Ihnen diese Daten im JSON-Format zurück. Bei korrekter Vorgehensweise analysiert die Plattform, die Sie mit WooCommerce verbinden, diese Daten, sodass sie in einem einfachen, nutzbaren Format für Ihre Endbenutzer bereitgestellt werden.
Wenn Sie diese GET-Funktion ausführen und einen 401-Code oder einen anderen nummerierten Code erhalten, liegt ein Fehler vor. Möglicherweise müssen Sie zurückgehen oder weitere Hilferessourcen der Plattform zur Fehlerbehebung konsultieren. Wenn die GET-Anfrage korrekt ausgeführt wurde, sollten Sie die JSON-Zeichenfolge im Abschnitt „Body“ Ihres Dashboards sehen.
2. Testen Sie eine PUT-Anfrage
Mithilfe der Daten aus unserer GET-Anfrage in Schritt 1 möchten Sie möglicherweise auch eine PUT-Anfrage prüfen. Nehmen wir für unser Beispiel an, dass das Produkt, das wir für diese Anfrage verwenden, die Produkt-ID 101 hat. Um die GET-Anfrage auszuführen, sieht unsere URL etwas anders aus:
https://yoursite.com/wp-json/wc/v3/products/101
Der Prozess, um daraus eine PUT-Funktion statt einer GET-Funktion zu machen, ist einfach:
- Neben dem URL-Feld befindet sich ein Dropdown-Menü
- Wählen Sie es aus und ändern Sie die Funktion von GET in PUT
- Wählen Sie im Körperbereich des Dashboards die Option „Roh“.
- Öffnen Sie das Dropdown-Menü „Text“ und wählen Sie JSON aus
Nachdem Sie diese Schritte abgeschlossen haben, können Sie nun Ihre Anfrage stellen. Ein Beispiel hierfür wäre, wenn Sie den Preis für Produkt Nr. 101 ändern möchten. Dazu geben Sie den folgenden Text ein:
“regular_price”: “50”
Anschließend können Sie die Ergebnisse auf Ihrer Website veröffentlichen, indem Sie auf „Senden“ klicken.
Nützliche E-Commerce-API-Anfragen
In Ihrem E-Commerce-Shop sind mehrere API-Anfragen hilfreich. Möglicherweise müssen Sie recherchieren, um eine API-Anfrage zu finden, die genau das tut, was Sie suchen, aber wir listen unten einige grundlegende auf, um Ihnen den Einstieg zu erleichtern.
GET-Anfragen
Hier sind die URLs für einige GET-Anfragen, die Sie in Ihrem E-Commerce-Shop umsetzen können:
- Holen Sie sich alle Produkte: https://yoursite.com/wp-json/wc/v3/products/
- ERHALTEN Sie alle Kunden: https://yoursite.com/wp-json/wc/v3/customers/
- ERHALTEN Sie einen einzelnen Kunden: https://yoursite.com/wp-json/wc/v3/customers/Kunden-ID
- Holen Sie sich alle Produktkategorien: https://yoursite.com//wp-json/wc/v3/products/categories
- Holen Sie sich eine Produktvariante: https://yoursite.com/wp-json/wc/v3/products/product ID/variations/variation ID
- ERHALTEN Sie ein einzelnes Produkt: https://yoursite.com/wp-json/wc/v3/products/Produkt-ID
PUT-Anfragen
Hier sind einige grundlegende PUT-Anfragen, die für Ihren Shop hilfreich sein könnten.
„id“: 1, „name“: „Color“, „slug“: „pa_color“, „type“: „select“, „order_by“: „name“, „has_archives“: true, „_links“: “selbst”: [
“href”: “https://example.com/wp-json/wc/v3/products/attributes/6″
]”Sammlung”: [
“href”: “https://example.com/wp-json/wc/v3/products/attributes”
]
„first_name“: „John“, „last_name“: „Doe“
“regular_price”: “81”
“regular_price”: “50”, “stock_quantity”: 30
“shipping”: “first_name”: “Jane”, “last_name”: “Doe”, “company”: “Jane Doe Co”, “address_1”: “361 Outside Rd”, “address_2”: “Suite 101” , „city“: „Las Vegas“, „state“: „NV“, „postcode“: „89102“, „country“: „US“
„id“: 20, „date_created“: „2018-09-08T21:47:19“, „date_created_gmt“: „2018-09-09T00:47:19“, „product_id“: 31, „status“: „ genehmigt”, “reviewer”: “Claudio Sanches”, “reviewer_email”: “[email protected]”, “review”: “Funktioniert jetzt einwandfrei.”, “rating”: 5, “verifiziert”: wahr, „reviewer_avatar_urls“: „24“: „https://secure.gravatar.com/avatar/908480753c07509e76322dc17d305c8b?s=24&d=mm&r=g“, „48“: „https://secure.gravatar.com/avatar/ 908480753c07509e76322dc17d305c8b?s=48&d=mm&r=g”, “96”: “https://secure.gravatar.com/avatar/908480753c07509e76322dc17d305c8b?s=96&d=mm&r=g” , “_links”: “self “: [
“href”: “https://example.com/wp-json/wc/v3/products/reviews/20″
]”Sammlung”: [
“href”: “https://example.com/wp-json/wc/v3/products/reviews”
]”hoch”: [
“href”: “https://example.com/wp-json/wc/v3/products/31”
]„Rezensent“: [
“embeddable”: true,
“href”: “https://example.com/wp-json/wp/v2/users/1”
]
Erweiterte Nutzung der WooCommerce-API
Zusätzlich zu den Grundlagen können Benutzer die WooCommerce-API auch nutzen, um einige erweiterte Funktionen für ihren E-Commerce-Shop zu verwalten. Einige der erweiterten Funktionen von WooCommerce sind:
- Benutzerdefinierte Paginierung – Mit der WooCommerce-API können Benutzer eine benutzerdefinierte Artikelnummer pro Seite erstellen, die zum Stil und Layout ihrer Website passt
- Webhooks – Benutzer können WooCommerce-Webhooks so programmieren, dass sie Ereignisse auf anderen Websites auslösen. E-Commerce-Shops können dies nutzen, um WooCommerce-Versandoptionen, Verpackung, den Rückgabeprozess und mehr zu unterstützen
- Asynchrone Aufgaben – Geschäfte können asynchrone Aufgaben auslösen, die separat ausgelöst werden, nachdem eine Bestellung bezahlt wurde oder ein Kunde ein Konto bei Ihrer Marke erstellt hat
- Daten filtern und sortieren – Sie können benutzerdefinierte Felder zu WooCommerce-Produkten hinzufügen und benutzerdefinierte Sortierfunktionen implementieren, um Ihr Kundenerlebnis zu verbessern
Best Practices und Tipps für WooCommerce
Die WooCommerce-API gibt Ihnen viel Freiheit bei der Anpassung Ihres E-Commerce-Shops. Es ist wichtig, dass Sie Ihren E-Commerce-Shop nicht „zu sehr anpassen“ und zu viele „Schnickschnack“ hinzufügen. Hier sind einige Best Practices, die Sie bei der Anpassung Ihres E-Commerce-Shops beachten sollten.
Verwenden Sie ein Plugin
Wenn Sie nur geringfügige Änderungen an Ihrem Shop vornehmen möchten, sollten Sie die Verwendung eines Plugins in Betracht ziehen. Alles wird innerhalb des Dashboards verwaltet und erfordert keinen zusätzlichen Code oder Textzeichenfolgen.
JetPack für WordPress ist ein nützliches Plugin für die grundlegende Anpassung von WooCommerce. Wenn die von Ihnen vorgenommenen Aktualisierungen nur Änderungen am Stylesheet oder CSS-Feed umfassen, ist diese Option genau das Richtige für Sie.
Darüber hinaus gibt es viele CSS-Plugin-Optionen verfügbar, wenn Sie globales CSS haben möchten, das nicht verloren geht, wenn Sie das aktive Theme oder Child-Theme ändern.
Verwenden Sie ein untergeordnetes Thema
Nach der Aktualisierung des Stylesheets oder CSS werden diese möglicherweise bei jedem Update Ihrer Website zurückgesetzt. Um Ihre Anpassungen beizubehalten, während WordPress Ihre Website weiterhin aktualisiert, sollten Sie die Verwendung eines untergeordneten Themes in Betracht ziehen.
Mit dem Child-Theme können Sie Änderungen vornehmen, ohne Code hinzuzufügen. Darüber hinaus gelten die von Ihnen vorgenommenen Änderungen auch für das übergeordnete Theme, sodass Sie sicher Aktualisierungen vornehmen können, um das gesamte Kundenerlebnis zu verbessern.
Erhalten Sie vollständig verwaltetes WooCommerce-Hosting
Die WooCommerce-API bietet viele zusätzliche Funktionen, die die Art und Weise, wie Sie Ihr E-Commerce-Geschäft betreiben, verändern können. Der richtige Einsatz kann das Kundenerlebnis verbessern, die Leistung des Ladengeschäfts verbessern und letztendlich den Gewinn steigern.
Aber ein leistungsstarkes Tool wie diese API ist nur so gut wie das Hosting, auf dem es läuft. Hostinger bietet leistungsstarkes, vollständig verwaltetes WordPress- und WooCommerce-Hosting. Kontaktieren Sie noch heute das Team und erfahren Sie, wie wir Ihr Unternehmen – und das Einkaufserlebnis Ihrer Kunden – auf die nächste Stufe heben können.
