Die Magento REST API verstehen

Bevor wir eine einzige Zeile React schreiben, verschaffen wir uns Klarheit über die Magento REST API selbst – ihre URL-Struktur, wie man ihre Erreichbarkeit ohne Anmeldung testet, und wo man ihre komplette Dokumentation findet.

Aufbau der Basis-URL

JEDER Magento-REST-API-Aufruf folgt demselben Muster:

https://IHR-SHOP.de/rest/<store_code>/V1/<endpunkt>

# Beispiel mit dem Standard-Store-Code 'default':
https://ihr-shop.de/rest/default/V1/products

# Ohne Store-Code greift der DEFAULT-Store der Website:
https://ihr-shop.de/rest/V1/products

<store_code> bestimmt, in welcher SPRACHE/welchem STORE-KONTEXT Produktnamen und -beschreibungen zurückgegeben werden (relevant, falls Ihr Shop mehrere Sprachen führt, wie unser eigener Mironsoft-Shop mit de und en). Den Store-Code Ihres Shops finden Sie im Magento-Admin unter Stores → All Stores in der Spalte "Store View Code".

V1: API-Versionierung

Das V1 im Pfad ist die API-Version – Magento hält aus Kompatibilitätsgründen an V1 fest, auch nachdem sich die interne Implementierung über Jahre weiterentwickelt hat. Für dieses Tutorial reicht es zu wissen: V1 ist aktuell die einzige relevante Version, Sie müssen sich um Versionierung nicht weiter kümmern.

Verbindungstest OHNE Anmeldung

Nicht JEDER Endpunkt verlangt einen Zugangs-Token. Manche sind bewusst als anonymous markiert, weil sie auch von einem nicht eingeloggten Storefront-Besucher gebraucht werden – etwa die allgemeine Store-Konfiguration. Perfekt, um als ERSTEN Schritt zu prüfen, ob Ihre Shop-Adresse und die API grundsätzlich erreichbar sind, BEVOR Authentifizierung überhaupt ins Spiel kommt:

curl -s https://IHR-SHOP.de/rest/V1/store/storeConfigs | head -c 300

Eine erfolgreiche Antwort ist ein JSON-Array mit Konfigurationsobjekten (Basis-URL, Store-Code, Währung, Sprache, ...) – sehen Sie stattdessen eine HTML-Fehlerseite oder "Connection refused", stimmt entweder die Adresse nicht, oder die REST API ist in Ihrer Magento-Installation nicht erreichbar (z. B. wegen einer Firewall- oder .htaccess-Einschränkung).

Achtung: In diesem Tutorial verwenden wir DURCHGEHEND https://IHR-SHOP.de als Platzhalter. Ersetzen Sie diesen bei JEDEM Code-Beispiel durch die tatsächliche Adresse Ihres eigenen Magento-Shops – ohne eigenen, erreichbaren Shop lässt sich dieses Tutorial nicht mit echten Ergebnissen nachvollziehen (siehe Kapitel 1).

Die eingebaute API-Dokumentation Ihres eigenen Shops

Jede Magento-Installation liefert ihre KOMPLETTE, interaktive REST-API-Dokumentation selbst mit – erreichbar unter:

https://IHR-SHOP.de/swagger

Tipp: Diese Swagger-Oberfläche listet JEDEN verfügbaren Endpunkt Ihrer KONKRETEN Magento-Version auf, inklusive aller Parameter und Beispiel-Antworten – der beste Ort, um später über dieses Tutorial hinaus weitere Endpunkte (Kategorien, Warenkorb, Kunden) zu erkunden.

Die Endpunkte, die wir in diesem Tutorial nutzen

POST /V1/integration/admin/token – Admin-Token anfordern (Kapitel 3), anonymous.
GET /V1/products – Produktliste mit Filtern/Pagination (Kapitel 7-8, 13), benötigt einen Token.
GET /V1/products/{sku} – ein einzelnes Produkt per SKU (Kapitel 10), benötigt einen Token.

Alle drei lernen wir in den kommenden Kapiteln im Detail kennen – zuerst mit dem schnellen Admin-Token, dann mit dem für Produktions-Apps geeigneteren Integration-Token.