Eine einfache Anleitung zur WooCommerce-API
Veröffentlicht: 2020-12-28Es besteht kein Zweifel, dass WordPress den gesamten Prozess der Veröffentlichung Ihrer Website einfacher und einfacher gemacht hat als auf den meisten anderen Plattformen. Als Beweis können Sie sich einfach die erstaunlichen Statistiken zur Nutzung des WordPress-Kerns ansehen. Darüber hinaus hat WooCommerce für den E-Commerce dasselbe getan wie WordPress für das Web-Publishing. Es ist nicht nur anfängerfreundlich, sondern bietet auch entwicklerfreundliche Tools wie die WooCommerce-API zur Optimierung Ihrer Website.
In diesem Artikel stellen wir die WooCommerce-REST-API vor und sprechen darüber, wie sie mit der WordPress-eigenen API zusammenhängt. Wir besprechen auch, warum Sie diese leistungsstarke Technologie verwenden möchten und wie Sie beginnen können.
Lass uns gleich einsteigen!
Einführung der WooCommerce REST API
Mit der WooCommerce-API können Sie benutzerdefinierte Funktionen für Ihre Website auf Softwareebene implementieren. Sie können auf eine Weise programmieren, die speziell für die Integration in WooCommerce entwickelt wurde. Daher können Sie praktisch jedes Feature oder jede Funktionalität erstellen, wenn Sie die Zeit, das Können und (möglicherweise) das Budget haben.
Um zu verstehen, wie diese Schlüsselfunktion funktioniert, sollten Sie sich mit zwei Begriffen vertraut machen:
- Repräsentativer Staatstransfer (REST). Dies ist ein kompliziertes Thema, aber für die Zwecke dieses Artikels ist REST eine Art "Webdienst", mit dem Sie auf bestimmte Elemente einer Webseite zugreifen können.
- Anwendungsprogrammierschnittstelle (API). Im Gegensatz zu einer grafischen Benutzeroberfläche (GUI) handelt es sich hierbei im Wesentlichen um eine Reihe von Code-Hooks und Filtern, mit denen Sie mit Access Points arbeiten können. Im Allgemeinen werden Sie sie in bestimmte WordPress-basierte Dateien codieren.
Mit anderen Worten, REST definiert, worauf Sie auf Ihrer Site über Code zugreifen können, und die API bietet Ihnen die Tools, um diesen Zugriff zu nutzen. Zusammen ermöglichen sie Ihnen, wesentliche Änderungen an der Funktionsweise Ihrer Website vorzunehmen.
Wie die WooCommerce-API mit der WordPress-REST-API zusammenhängt
Bei ihrer Einführung war die WooCommerce-API eine einzige Einheit. Mit anderen Worten, es wurde ausschließlich für den Zugriff auf WooCommerce-Endpunkte entwickelt und beeinflusste keine anderen Elemente von WordPress.
Nach der Einführung der WordPress-REST-API wurden die Endpunkte von WooCommerce jedoch zusammengeführt, um eine übergreifende Anlaufstelle für den Zugriff auf WordPress unter der Haube zu schaffen. Trotzdem gibt es immer noch eine Dokumentation für die WooCommerce-API. Wenn Sie sich die Einführung dieses Dokuments durchlesen, wird die Geschichte der API grob umrissen.
Für die Zwecke dieses Artikels betrachten wir die 'WooCommerce API' als eine Sammlung spezifischer Endpunkte für diese E-Commerce-Plattform. Natürlich werden auch Kernendpunkte nützlich sein, daher werden wir auch einige davon erwähnen. Kurz gesagt, es ist am besten, sich nicht daran zu hängen, diese beiden APIs zu trennen – sie sind jetzt ein und dasselbe.
Warum Sie die WooCommerce-API verwenden möchten
Sie werden vielleicht schon sehen, warum die WooCommerce REST API ein aufregender und leistungsstarker Pfeil im Köcher Ihres Shops ist. Hier sind nur einige der Gründe, die Sie in Betracht ziehen könnten, es zu verwenden:
- Sie müssen benutzerdefinierte Funktionen implementieren. Wenn Sie durch Plugins, Themes oder zusätzliche Code-Snippets nicht finden, was Sie brauchen, könnte es eine Option sein, die Funktionalität selbst zu erstellen.
- Kunden können ein benutzerdefiniertes Frontend erhalten. Mit den umfassenderen Funktionen der WordPress-REST-API kannst du das Frontend deiner Website vom Backend entkoppeln. Auf diese Weise können Sie die Leistungsfähigkeit von WordPress unter der Haube nutzen und gleichzeitig Seitenlayouts und Designs in einer anderen Sprache erstellen.
- Ihr Team kann benutzerdefinierte Back-Ends verwenden. So wie Ihre Kunden möglicherweise ein einzigartiges Front-End-Erlebnis erhalten, können Sie verschiedene Teile von WooCommerce einbeziehen, um ein benutzerdefiniertes Back-End-Dashboard zu erstellen. Sie können nahezu alle gewünschten Metriken oder Daten einbeziehen und im Wesentlichen Ihre eigene Benutzeroberfläche und Analyseplattform erstellen.
Was auch immer Ihre Gründe sein mögen, die WooCommerce-API bietet einige sehr leistungsstarke Funktionen. Um dies weiter zu demonstrieren, sehen wir uns einige Besonderheiten dieser API an und sehen, wo und wie sie auf Ihrer Website verwendet werden kann.
Was Sie mit der WooCommerce-API erreichen können (4 Beispiele)
Es ist verlockend, einfach zu sagen: „Alles ist möglich“, wenn es um die WooCommerce-API geht. Es lohnt sich jedoch, einige häufig auftretende Aufgaben zusammen mit einigen spezifischen Anwendungsfällen zu betrachten.
1. Produkte erstellen, aktualisieren und löschen
Da die Produkte Ihres Shops das Lebenselixier Ihres Unternehmens sind, bietet die WooCommerce-API viele Optionen, um sicherzustellen, dass Sie sie alle verwalten können. Sie können mit praktisch allen in WooCommerce gesammelten Informationen arbeiten, obwohl einige Endpunkte schreibgeschützt sind. Es gibt sogar separate APIs für einzelne Produkte, Variationen, Attribute und deren Begriffe, Taxonomien, Versandklassen und Bewertungen.
Es gibt viele Möglichkeiten, wie dies nützlich sein kann. Betrachten Sie beispielsweise eine Marktplatz-Site, auf der Benutzer ihre eigenen Produkte hochladen. Sie können einen Front-End-Uploader erstellen, um erforderliche Verwaltungsaufgaben basierend auf Benutzereingaben auszuführen. Sie können auch viele verwandte Produktbewertungen basierend auf einer Benutzeranfrage stapelweise bearbeiten, identifizierende E-Mails entfernen und vieles mehr.
2. Bestellungen und die dazugehörigen Notizen bearbeiten
Wenn Produkte das Lebenselixier Ihres Ladens sind, sind Bestellungen der Raketentreibstoff. Als solche bietet die WooCommerce-API viel, um Sie bei der Verwaltung von Bestellungen und Notizen zu unterstützen. Auf praktisch jede in WooCommerce gefundene Eigenschaft kann zugegriffen werden, zusammen mit den zugehörigen Abrechnungs-, Versand- und Metadateneigenschaften.
Wir würden argumentieren, dass die Mehrheit der Verwendungen für diesen Endpunkt darin besteht, Bestellungen in irgendeiner Weise aufzulisten. Schon ein einfaches einzeiliges Snippet bietet Ihnen immense Leistung. Beispielsweise kann eine Liste nach mehreren Erwähnungen desselben Produkts geparst, für Bestellungen gezählt werden, bei denen ein Mehrfachkorb einen bestimmten Artikel enthielt, und vieles mehr.

Die Stapelaktualisierung von Bestellnotizen ist eine weitere hilfreiche Verwendung für diesen Aspekt der API. Wenn Sie eine Sammlung von Weihnachtsbestellungen erstellen, sie basierend auf dem jeweiligen Status aufteilen und die resultierende JSON in einer Tabelle organisieren, können Sie Bestellungen schneller und effizienter liefern.
3. Steuersätze und -klassen anpassen
Steuern bereiten vielen Ladenbesitzern Kopfschmerzen, insbesondere wenn es um internationale Bestellungen geht. Da es viele verschiedene Möglichkeiten gibt, Steuern zu unterschiedlichen Sätzen zu erheben, bietet die WooCommerce-API mehrere Möglichkeiten, mit diesen Daten zu arbeiten. Die Endpunkte werden in zwei Varianten unterteilt:
- Steuersätze: Hier wird der tatsächliche Prozentsatz zusammen mit einigen anderen identifizierenden Daten erfasst.
- Steuerklassen: Dies sind breite Steuerbereiche, auf die die Steuersätze angewendet werden.
Sie können beispielsweise einen Steuersatz von 20 % erstellen, der auf die Klasse "Standardsatz" angewendet wird. Tatsächlich ist die Möglichkeit, Steuersätze stapelweise zu aktualisieren, eine gute Verwendung der WooCommerce-API. Ein einzigartigeres Beispiel wäre ein Setup, bei dem ein Steuersatz oder eine Steuerklasse basierend auf einem bestimmten Kundenattribut erstellt wird. Dies ist ideal für Situationen, in denen Sie einen Kunden "qualifizieren" müssen, bevor Sie ihn registrieren oder an den Checkout-Prozess senden.
4. Legen Sie Versandzonen, Standorte und Methoden fest
Wenn Sie jemals versucht haben, in WooCommerce mit Versand zu arbeiten, werden Sie verstehen, was für ein Minenfeld es sein kann. Wenn Sie ein Element falsch verstehen, ist der Kunde direkt in einem Bereich betroffen, der für schlechtes Feedback und Bewertungen reif ist. Glücklicherweise kann die WooCommerce-API mit allen mit dem Versand verbundenen Endpunkten wie Zonen, Standorten und Methoden arbeiten.
Im Vergleich zu anderen Aspekten der API gibt es hier nicht allzu viele Attribute, mit denen man arbeiten könnte. Es gibt jedoch noch viele Optionen, die Ihnen bei der Arbeit mit den Daten Ihres Geschäfts helfen. Obwohl Sie Versandinformationen oft „einstellen und vergessen“ möchten (angesichts der Komplexität und der Auswirkungen auf die Benutzererfahrung), gibt es dennoch einige praktische Anwendungen.
Zum Beispiel werden Sie wahrscheinlich die aktuellen COVID-19-Vorschriften sowohl auf bundesstaatlicher als auch auf landesweiter Basis beachten. Vor diesem Hintergrund können Sie eine Kombination von Endpunkten verwenden, um den Versand vorübergehend auf bestimmte Orte zu beschränken. Darüber hinaus können Sie die Benutzer zum Zeitpunkt des Kaufs über Verzögerungen informieren. Dies kann auf dem Kassenbildschirm oder durch Massenkommunikation geschehen.
So beginnen Sie mit der Verwendung der WooCommerce-API
Die WooCommerce REST API funktioniert über ein digitales schlüsselbasiertes System zur Gewährung von Zugriff und Berechtigungen. Dieser Authentifizierungsprozess umfasst zwei unterschiedliche Schritte:
- WooCommerce erstellt zwei Schlüssel: einen Consumer Key und einen Secret Key . Sie bestehen aus zufälligen Zeichenfolgen und sind praktisch unmöglich zu knacken.
- Wenn Sie die REST-API aufrufen möchten, müssen Sie diese Schlüssel als Authentifizierungsnachweis bereitstellen.
Dieser Vorgang ist unkompliziert, aber um diese Schlüssel zu erhalten (und die API selbst zu verwenden), müssen Sie in Ihr WooCommerce-Dashboard gehen – insbesondere zum Bildschirm WooCommerce> Einstellungen> Erweitert . Suchen Sie oben nach dem REST-API-Link, navigieren Sie zu diesem Bildschirm und klicken Sie dann auf die Schaltfläche API-Schlüssel erstellen :

Füllen Sie als Nächstes das Feld Beschreibung aus, während Sie die anderen vorerst unverändert lassen. Dies sollte eine einfache Beschreibung dessen sein, wofür der Zugriff gedacht ist:

Wählen Sie abschließend die Schaltfläche API-Schlüssel generieren aus und warten Sie, bis WordPress seine Arbeit erledigt hat. Sie sehen hier einen Consumer Key und Secret Key , einen QR-Code für die weitere Authentifizierung und einen Link, um den API-Zugriff in Zukunft zu widerrufen. Es ist wichtig, die Schlüssel jetzt zu kopieren, da Sie sie später nicht mehr abrufen können.
An diesem Punkt können Sie mit der Codierung beginnen. Wenn dies etwas Neues für Sie ist, ist es eine gute Idee, einen Entwickler zur Unterstützung einzustellen. Wenn Sie jedoch selbst einsteigen möchten, können Sie einen Großteil der schweren Arbeit mit einem "API-Client" wie Postman oder Insomnia erledigen:

Um einen Einblick in die Verwendung der WooCommerce-API aus der Praxis zu erhalten, können Sie Entwickler-Blogs zu diesem Thema lesen. James Kemp von IconicWP bietet beispielsweise nützliche Einblicke, wie sich eine PHP-Webanwendung und eine Handvoll Code mit einem E-Commerce-Shop verbinden und seine Daten verarbeiten können.
Abschluss
Wenn es darum geht, eine Plattform zu wählen, die sowohl für Benutzer als auch für Entwickler freundlich ist, ist WordPress wohl die Nummer eins. Darüber hinaus ist WooCommerce für Ladenbesitzer genauso freundlich, die Einfachheit, Leistung und Flexibilität wünschen. Ein Teil dessen, was es so anpassungsfähig macht, ist die WooCommerce REST API. Obwohl dies einst eine separate Einheit war, wurde sie jetzt in die Haupt-REST-API von WordPress integriert.
Dieser Artikel hat sich die WooCommerce-API angesehen und Ihnen einen Einblick in die Möglichkeiten gegeben, die Sie damit machen können. Sie sollten die Kernkonzepte genau kennen oder einen Entwickler beauftragen, die gewünschten Funktionen zu implementieren. In jedem Fall kann sich die Leistung dieser API direkt positiv auf Ihr Geschäft und Ihr Einkommen auswirken.
Überlegen Sie, die WooCommerce-API für Ihren Shop zu verwenden, und wenn ja, was begeistert Sie daran am meisten? Lass es uns im Kommentarbereich unten wissen!
Bildnachweis: Monkographic / shutterstock.com
