Ein CSV-Upload per Cronjob gilt in vielen Magento-Projekten noch immer als Import-Strategie. Spätestens wenn ERP, PIM und Marktplatz-Anbindung gleichzeitig Daten in den Shop schreiben, bricht dieses Konstrukt auseinander. Die Magento 2 REST API ist deshalb kein optionaler Integrationsweg, sondern der von Adobe offiziell dokumentierte Standard, über den externe Systeme mit Adobe Commerce und Magento Open Source kommunizieren — von der Warenwirtschaft bis zum Lieferantenportal.
Warum setzen Händler beim Produkt-Import auf die REST API?
Weil sie Systemgrenzen auflöst, ohne den Shop-Core anzufassen. Über Endpunkte wie /V1/products und /V1/stockItems lassen sich Artikelstammdaten, Preise und Lagerbestände gezielt einzeln schreiben — validiert durch dieselben Service Contracts, die auch das Admin-Panel nutzt. Wer per REST importiert, umgeht die bekannten Fallstricke direkter Datenbank-Imports: fehlende Index-Updates, inkonsistente EAV-Attribute, kaputte URL-Rewrites.
Die Authentifizierung läuft über Integration Tokens oder OAuth. Adobe empfiehlt für produktive Anbindungen klar dedizierte Integrationen mit minimalen ACL-Rechten: Ein Token, das nur Produktdaten schreiben darf, richtet bei einem Leak deutlich weniger Schaden an als ein Admin-Token mit Vollzugriff. Klingt banal, ist in Audits aber einer der häufigsten Befunde — generierte Admin-Tokens in Skripten, die seit Jahren niemand mehr pflegt.
Wie skaliert der Import bei großen Katalogen?
Hier trennt sich die Praxis vom Tutorial. Synchrone Requests funktionieren bei ein paar hundert SKUs problemlos; bei 50.000 Artikeln dauert ein Vollimport Stunden und blockiert PHP-Worker, die eigentlich Checkout-Anfragen bedienen sollten. Adobe stellt dafür die asynchrone Bulk API bereit: Requests an Endpunkte wie /async/bulk/V1/products landen in einer Message Queue und werden von Consumern im Hintergrund abgearbeitet, inklusive Status-Tracking pro Batch.
Voraussetzung ist ein konfigurierter RabbitMQ-Broker. Auf Hosting-Umgebungen ohne Queue-Support bleibt dieser Weg verschlossen — ein Punkt, den Händler vor der Wahl des Import-Konzepts mit ihrem Hoster klären müssen. Alternativ funktioniert ein Batch-Konzept mit kleinen synchronen Chunks und konsequentem Rate-Limiting, nur eben spürbar langsamer.
Wer keinen eigenen Connector entwickeln will, greift zu etablierten Import-Extensions wie Firebear Studios Improved Import & Export, die REST-Quellen, Feld-Mapping und Cronjob-Steuerung in einem Modul bündeln. Solche Werkzeuge ersetzen keine durchdachte API-Strategie, senken aber die Einstiegshürde für Teams ohne dedizierte Backend-Entwicklung.
Was Shop-Betreiber jetzt prüfen sollten
Drei Punkte gehören auf die nächste Sprint-Liste. Erstens: alle bestehenden API-Tokens inventarisieren und deren Rechte gegen den tatsächlichen Bedarf prüfen. Zweitens: klären, ob Importe synchron laufen, obwohl das Katalogvolumen längst für die Bulk API spricht. Drittens: bei geplanten ERP- oder PIM-Projekten früh festlegen, welches System führt — doppelte Schreibwege auf denselben Stammdaten sind der sicherste Weg zu Bestandschaos.
Die API selbst ist reif und stabil dokumentiert. Was in Magento-Projekten scheitert, ist selten die Technik — sondern die Tatsache, dass niemand die Anbindung besitzt, nachdem die Agentur das Projekt abgeschlossen hat.