Zeit für Ihr ERSTES echtes Ergebnis: ein gültiger Zugangs-Token und Ihre echten Magento-Produkte als JSON – alles noch VOR der ersten Zeile React-Code, per curl im Terminal.

Token per Admin-Login anfordern

POST /V1/integration/admin/token nimmt Benutzername und Passwort eines existierenden Magento-Admin-Accounts entgegen und liefert im Erfolgsfall einen Zugangs-Token zurück:

curl -s -X POST https://IHR-SHOP.de/rest/V1/integration/admin/token \
  -H "Content-Type: application/json" \
  -d '{"username": "IHR_ADMIN_BENUTZERNAME", "password": "IHR_ADMIN_PASSWORT"}'

Die Antwort ist ein einzelner, in Anführungszeichen gesetzter JSON-String – GENAU dieser String (ohne die äußeren Anführungszeichen) ist Ihr Token:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Den Token für eine echte Produktanfrage nutzen

Mit dem Token im Authorization-Header als Bearer-Token ausgestattet, liefert GET /V1/products Ihre echten Produktdaten:

TOKEN="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

curl -s https://IHR-SHOP.de/rest/V1/products?searchCriteria%5BpageSize%5D=2 \
  -H "Authorization: Bearer $TOKEN" | python3 -m json.tool

searchCriteria%5BpageSize%5D=2 ist die URL-kodierte Form von searchCriteria[pageSize]=2 (eckige Klammern müssen in URLs kodiert werden) und begrenzt die Antwort testweise auf 2 Produkte – mehr zu searchCriteria in Kapitel 8.

Die Antwortstruktur im Überblick

Eine GET /V1/products-Antwort hat IMMER dieselbe Grundform, egal wie viele Produkte zurückkommen:

{
  "items": [ { "sku": "...", "name": "...", "price": 19.99, ... }, ... ],
  "search_criteria": { ... },
  "total_count": 247
}

items ist das Array der eigentlichen Produkte, total_count die GESAMTANZAHL passender Produkte (unabhängig von pageSize) – wichtig für die Pagination in Kapitel 8. Ein einzelnes Produktobjekt untersuchen wir im Detail in Kapitel 10, sobald wir die Detailseite bauen.

Hinweis für Shops mit aktivierter Zwei-Faktor-Authentifizierung