All posts
Index

Magento API-Fehler beheben: Der vollständige Entwickler-Leitfaden 2026 für Adobe Commerce


Ausgabe 2026 · 12 Min. Lesezeit · Vom ShippyPro-Team

Adobe Commerce (ehemals Magento 2) gilt als die flexibelste E-Commerce-Plattform auf dem Markt — doch diese Flexibilität hat einen Preis: außerordentliche Strenge bei der API-Validierung. Ob Sie ein ERP, ein PIM oder eine Versandautomatisierungsplattform wie ShippyPro anbinden — die Magento 2 REST API ist wenig vergebend. Ein einziges fehlendes Komma im JSON-Payload oder eine minimal fehlerhafte Access Control List (ACL) kann Ihre gesamte Datensynchronisation zum Stillstand bringen. Anders als andere Plattformen, die mit hilfreichen Meldungen wie „Ungültige E-Mail-Adresse" antworten, liefert Magento häufig generische HTTP-Statuscodes, die Sie im Unklaren lassen. Dieser Leitfaden geht über einfache Definitionen hinaus: Wir dekonstruieren die Logik hinter den häufigsten Magento API-Fehlern, zeigen Ihnen die serverseitigen Logs, die Sie im Blick behalten müssen, und liefern dauerhafte architektonische Fixes für stabile Integrationen. Starten Sie eine neue Integration? Folgen Sie unserer Schritt-für-Schritt-Anleitung zur Verbindung von Magento 2 mit ShippyPro.

Magento API Fehlercode 401 403 404 500 Debugging Terminal Ausgabe Entwickler
Die vier häufigsten Magento API-Fehlercodes und ihre Ursachen — von abgelaufenen Tokens bis zu PHP-Abstürzen.

🗝 Das Wichtigste — Spickzettel für Entwickler

  1. 401 Unauthorized: Ihr Token ist abgelaufen. Lösung: Wechseln Sie von Admin-User-Tokens (4-Stunden-Gültigkeit) zu Integration Tokens (permanent, kein Ablaufdatum).
  2. 403 Forbidden: Sie sind angemeldet, aber Ihre Berechtigungen sind falsch konfiguriert. Lösung: Prüfen Sie unter System > Benutzerrollen > Ressourcen die ACL-Einstellungen Ihrer Integration.
  3. 404 Not Found: Der Endpunkt existiert, aber der Store-Scope fehlt in der URL. Lösung: Ergänzen Sie /all/ oder /default/ im URL-Pfad (z. B. /rest/default/V1/...).
  4. 500 Internal Server Error: PHP ist abgestürzt. Lösung: Ignorieren Sie die API-Antwort. Verbinden Sie sich per SSH mit Ihrem Server und führen Sie tail -f var/log/exception.log aus, um den echten PHP-Fehler zu sehen.
  5. DSGVO-Hinweis für DE-Entwickler: Alle API-Aufrufe, die personenbezogene Kundendaten verarbeiten (Namen, Adressen, E-Mail), müssen im Verarbeitungsverzeichnis dokumentiert sein. Logging-Konfigurationen sollten keine Kundendaten in Klartext in Logfiles schreiben.

Fehler 401 Unauthorized — Die Token-Falle

Dies ist die häufigste Hürde bei neuen Magento-Integrationen. Sie senden eine korrekte Anfrage, Magento verweigert jedoch die Verarbeitung mit dem HTTP-Statuscode 401. Der Fehler tritt besonders heimtückisch auf, weil die Integration beim initialen Test einwandfrei funktioniert — und dann nachts oder am Wochenende still abbricht.

401
Unauthorized
Token abgelaufen oder ungültig. Admin-User-Tokens haben eine Standard-Gültigkeitsdauer von nur 4 Stunden.
→ Integration Token erstellen

Ursache: Admin-Token vs. Integration-Token

Magento bietet mehrere Authentifizierungsmethoden. Ein verbreiteter Fehler ist die Verwendung des Admin-Token-Endpunkts (POST /V1/integration/admin/token) für externe Applikationen. Admin-Tokens sind für menschliche Sessions konzipiert und laufen standardmäßig nach 4 Stunden ab. Wenn Ihr Skript einen gestern generierten Token fest kodiert, schlägt es heute fehl. Die Integration funktioniert perfekt beim Testen — und bricht über Nacht ab, wenn der Token seine Gültigkeitsdauer überschritten hat. Wenn Sie vermuten, dass Ihre Zugangsdaten ungültig sind, prüfen Sie zunächst unseren Leitfaden zur Behebung von Magento 2-Verbindungsproblemen.

Dauerhafter Fix: Integration mit permanentem Bearer Token erstellen

1
Magento Admin-Panel öffnen

Melden Sie sich im Magento Admin-Panel an und navigieren Sie zu System > Erweiterungen > Integrationen.

 
2
Neue Integration anlegen

Klicken Sie auf Neue Integration hinzufügen. Vergeben Sie einen aussagekräftigen Namen (z. B. „ShippyPro-Verbindung" oder „ERP-Anbindung") und geben Sie Ihr Admin-Passwort zur Bestätigung ein.

 
3
API-Ressourcen gezielt zuweisen (Sicherheitskritisch)

Klicken Sie auf den Tab API in der linken Navigationsleiste. Wählen Sie ausschließlich die Ressourcen aus, die diese Integration tatsächlich benötigt — z. B. „Bestellungen", „Katalog", „Versand". Gewähren Sie niemals vollständigen Admin-Zugriff, wenn er nicht zwingend erforderlich ist.

💡 Minimale Rechtevergabe (Principle of Least Privilege) ist nicht nur Best Practice — für Applikationen, die personenbezogene Daten nach DSGVO verarbeiten, ist sie eine Compliance-Anforderung.
 
4
Speichern, aktivieren und Token sichern

Klicken Sie auf Speichern und dann auf Aktivieren. Magento zeigt den Access Token einmalig an. Kopieren Sie ihn sofort und speichern Sie ihn sicher — er wird nicht erneut angezeigt.

 
5
Token im Authorization-Header verwenden

Verwenden Sie den Token in jedem API-Request im Header: Authorization: Bearer <ihr_token>. Dieser Token läuft nicht ab, solange er nicht manuell widerrufen wird.

💡 Speichern Sie den Token niemals im Quellcode-Repository. Verwenden Sie Umgebungsvariablen oder einen Secret Manager.
HTTP Request — Korrekte Authorization mit Integration Token
GET /rest/default/V1/orders?searchCriteria[pageSize]=20 HTTP/1.1 Host: ihr-magento-shop.de Authorization: Bearer eyJraWQiOiIxIiwiYWxnIjoiSFMyNTYifQ... Content-Type: application/json Accept: application/json

Fehler 403 Forbidden — Das ACL-Labyrinth

403
Forbidden — Zugriff verweigert
Authentifizierung erfolgreich, aber die Integration hat keine Berechtigung für diese API-Ressource.
→ ACL-Ressourcen prüfen

Ursache: Access Control List (ACL) fehlerhaft konfiguriert

Ein 403-Fehler bedeutet: Magento kennt Sie (Authentifizierung erfolgreich), verweigert aber den Zugriff auf die angeforderte Ressource, weil Ihrer Integration die notwendige Berechtigung fehlt. Dies tritt am häufigsten nach Updates auf, bei denen neue API-Ressourcen eingeführt wurden, die in bestehenden Integrationsberechtigungen noch nicht enthalten sind, oder wenn ein Administrator die Ressourcen einer Integration nachträglich eingeschränkt hat.

Fix: ACL-Ressourcen für die Integration erweitern

Typische 403-Fehlermeldung von Magento
{ "message": "The consumer isn't authorized to access %resources.", "parameters": { "resources": "Magento_Sales::sales" } }

Die Fehlermeldung zeigt Ihnen direkt, welche Ressource fehlt — in diesem Fall Magento_Sales::sales. Navigieren Sie zu System > Erweiterungen > Integrationen, öffnen Sie die betreffende Integration, klicken Sie auf den API-Tab und aktivieren Sie die fehlende Ressource. Nach dem Speichern und erneuten Aktivieren steht der aktualisierte Token sofort zur Verfügung, ohne dass ein neuer Token generiert werden muss.

⚠ Achtung — Niemals „Alle Ressourcen" aktivieren für Produktiv-Integrationen

Die Versuchung ist groß, bei 403-Fehlern einfach alle Ressourcen zu aktivieren, um das Problem schnell zu lösen. In einer Produktivumgebung ist dies ein gravierendes Sicherheitsrisiko: Eine kompromittierte Integration hätte damit vollständigen Admin-Zugriff auf Ihren gesamten Shop — inklusive Kundendaten, Zahlungsinformationen und Systemkonfiguration. Gewähren Sie ausschließlich die Ressourcen, die für die jeweilige Integration zwingend erforderlich sind.

Fehler 404 Not Found — Das Routing-Phantom

404
Not Found — Endpunkt nicht gefunden
Der Endpunkt existiert laut Dokumentation — aber Magento findet ihn nicht, weil der Store-Scope in der URL fehlt.
→ /default/ oder /all/ ergänzen

Ursache: Magento 2 Multi-Store-Architektur und fehlender Scope

Sie schauen in die Adobe Commerce Swagger-Dokumentation. Der Endpunkt /V1/products/{sku} existiert zweifelsfrei. Dennoch erhalten Sie beim Aufruf einen 404. Der Grund liegt in der Multi-Store-Architektur von Magento 2: Das System unterstützt mehrere Websites, Shops und Store-Views (Sprachen) auf einer einzigen Installation. Wenn Sie den Root-Pfad /rest/V1/... ohne expliziten Scope aufrufen, versucht Magento zu erraten, welchen Store Sie meinen — und scheitert bei komplexen Konfigurationen oder wenn Sie auf Store-spezifische Daten (wie übersetzte Produktbeschreibungen für den deutschen Store) zugreifen wollen.

Fix: Explizites Scope-Routing in der URL

URL-Routing — Falsch vs. Korrekt
❌ Mehrdeutige Anfrage (führt zu 404): GET https://ihr-shop.de/rest/V1/products/MEIN-SKU-123 ✅ Korrekte Anfrage — Standard-Store (storefront-spezifische Werte): GET https://ihr-shop.de/rest/default/V1/products/MEIN-SKU-123 ✅ Korrekte Anfrage — Globaler Scope (systemweite Werte, z. B. Basiswährungspreis): GET https://ihr-shop.de/rest/all/V1/products/MEIN-SKU-123 ✅ Spezifischer Store-View (z. B. deutscher Store): GET https://ihr-shop.de/rest/de/V1/products/MEIN-SKU-123
💡 Pro Tip — Wann /all/ und wann /default/ verwenden?

Verwenden Sie /all/, wenn Sie systemweite Werte abrufen oder setzen möchten — z. B. den Basispreis in der Systemwährung oder globale Konfigurationswerte. Verwenden Sie /default/ (oder einen spezifischen Store-Code wie /de/), wenn Sie storefront-spezifische Werte benötigen — z. B. übersetzte Produktnamen, länderspezifische Preise oder lokalisierte Kategorienamen. Für die ShippyPro-Integration empfehlen wir in der Regel /default/ für Bestellabrufe und /all/ für Produktkatalog-Synchronisationen.

Fehler 400 Bad Request — Der strenge Bibliothekar

400
Bad Request — Ungültige Anfragedaten
Der Server hat die Anfrage empfangen, aber wegen ungültigem oder nicht schema-konformem JSON-Payload abgelehnt.
→ Swagger lokal testen

Die häufigsten Ursachen für 400-Fehler in Magento 2

Ein 400-Fehler bedeutet, dass der Server Ihre Anfrage empfangen hat, sie aber wegen nicht schema-konformer Daten abgelehnt hat. In Magento treten folgende Ursachen besonders häufig auf:

Erstens JSON-Syntaxfehler: Ein abschließendes Komma am Ende eines JSON-Objekts ist in JavaScript valide, im JSON-Standard jedoch ungültig. Magento's Parser lehnt es ab. Zweitens fehlende Pflichtfelder: Wenn Sie versuchen, einen Kunden anzulegen, ohne email oder lastname zu übergeben, gibt die API einen 400 zurück. Drittens Typkonflikte bei Attributen: Das Senden eines String-Werts "10" an ein Feld, das als integer oder float definiert ist, kann im strikten Validierungsmodus zu Fehlern führen — besonders bei Custom Attributes.

Fix: Lokal mit Ihrer eigenen Magento-Swagger-Instanz testen

Häufiger 400-Fehler — Trailing Comma im JSON
❌ Ungültiges JSON (trailing comma): { "customer": { "email": "kunde@beispiel.de", "firstname": "Max", "lastname": "Mustermann", ← Dieses Komma verursacht den 400 } } ✅ Valides JSON: { "customer": { "email": "kunde@beispiel.de", "firstname": "Max", "lastname": "Mustermann" } }

Verlassen Sie sich nicht auf generische Online-Dokumentation. Magento generiert eine interaktive API-Dokumentation auf Basis Ihrer spezifischen Instanz — inklusive aller Custom Attributes und Module. Rufen Sie dazu https://ihr-magento-shop.de/swagger auf. Testen Sie Ihren Payload dort interaktiv. Wenn er in Swagger funktioniert, funktioniert er auch in Ihrem Code. Dies ist besonders wichtig für DACH-Shops mit Custom Attributes für B2B-Kunden wie USt-IdNr. oder Steuernummer.

Magento 2 Swagger Benutzeroberfläche lokale API Dokumentation Endpunkt testen
Die lokale Magento Swagger-Oberfläche zeigt das exakte JSON-Schema Ihrer Instanz — inklusive aller Custom Attributes Ihres Shops.

Fehler 500 Internal Server Error — Die Blackbox

500
Internal Server Error — PHP-Absturz
PHP ist abgestürzt. Die API-Antwort enthält keine nützlichen Informationen — der echte Fehler liegt in den Server-Logs.
→ exception.log per SSH prüfen

Ursachen für 500-Fehler in Magento 2

Ein 500-Fehler ist der gefürchtetste, weil die API-Antwort keinerlei nützliche Information liefert — in der Regel nur {"message": "Internal Server Error"}. Die tatsächliche Ursache liegt auf dem Server. Typische Auslöser sind: Speicherüberschreitungen (z. B. beim Laden von 5.000 Produkten in einem einzigen API-Call, der das PHP-Memory-Limit überschreitet), Plugin-Konflikte (ein Observer oder Plugin, das durch Ihren API-Save-Aufruf ausgelöst wird und einen eigenen Bug enthält) sowie Datenbankblockierungen (ein anderer Prozess blockiert die Zeile, die Sie zu aktualisieren versuchen).

Fix: Der tail-Befehl — Echtzeit-Debugging auf dem Server

SSH — Echtzeit-Log-Monitoring für Magento 2
# Schritt 1: Per SSH mit dem Magento-Server verbinden ssh deploy@ihr-server.de # Schritt 2: In das Magento-Root-Verzeichnis wechseln cd /var/www/html/magento # Schritt 3: Logs in Echtzeit beobachten (beide gleichzeitig) tail -f var/log/exception.log var/log/system.log # Schritt 4: Den fehlgeschlagenen API-Call erneut ausführen # Der Stack Trace erscheint sofort im Terminal # Typische Fehlermuster, auf die Sie achten sollten: # → "Uncaught Error: Call to a member function..." = Null-Pointer-Problem # → "SQLSTATE[HY000]: General error: 1205 Lock..." = Datenbankblockierung # → "PHP Fatal error: Allowed memory size of..." = Memory-Limit überschritten

Erweiterter Fix: Async/Bulk API für Massenoperationen

Wenn Sie häufig mit 504 Gateway Timeouts oder 500-Fehlern bei der Aktualisierung großer Kataloge oder Bestelllisten konfrontiert sind, sollten Sie die Standard-REST-Endpunkte nicht weiter verwenden. Magento 2 bietet eine Async/Bulk API (/async/bulk/V1/...), die genau für diese Szenarien entwickelt wurde.

Async Bulk API — Massenaktualisierung von Produktpreisen
POST /rest/async/bulk/V1/products HTTP/1.1 Host: ihr-shop.de Authorization: Bearer <ihr_integration_token> Content-Type: application/json [ { "product": { "sku": "ARTIKEL-001", "price": 29.99 } }, { "product": { "sku": "ARTIKEL-002", "price": 49.99 } } ] // Sofortige Antwort (202 Accepted): { "bulk_uuid": "b5d97a8e-1234-5678-abcd-ef0123456789", "request_items": [...], "errors": false } // Bulk-Status später abfragen: GET /rest/V1/bulk/b5d97a8e-1234-5678-abcd-ef0123456789/status
💡 Pro Tip — Bulk API für ShippyPro-Versandstatus-Updates

Wenn Sie über die ShippyPro-API Versandstatus-Updates für große Bestellmengen zurück in Magento schreiben möchten, empfehlen wir dringend die Async Bulk API. Statt hundert einzelne PUT /V1/orders/{id}/ship-Calls abzusetzen, bündeln Sie alle Updates in einem einzigen Bulk-Call. Magento akzeptiert die Anfrage sofort mit 202 Accepted und verarbeitet die Updates im Hintergrund über RabbitMQ — ohne Timeouts und Memory-Abstürze. Details zur API-Integration finden Sie in der ShippyPro API-Dokumentation.

Weitere häufige Fehlercodes: 405, 503 und searchCriteria-Fehler

405 Method Not Allowed

Ein 405-Fehler bedeutet, dass Sie die falsche HTTP-Methode für den Endpunkt verwendet haben — beispielsweise POST auf einem Endpunkt, der nur PUT akzeptiert, oder GET auf einem Endpunkt, der PATCH erwartet. Prüfen Sie die Swagger-Dokumentation Ihrer Instanz für die korrekte Methode.

503 Service Unavailable — Wartungsmodus

Magento Wartungsmodus — Diagnose und Deaktivierung
# Wartungsmodus-Status prüfen bin/magento maintenance:status # Wartungsmodus deaktivieren bin/magento maintenance:disable # Cache leeren nach dem Deaktivieren bin/magento cache:flush

searchCriteria — Bestellungen nach Datum filtern

Magento verwendet ein eigenes searchCriteria-Format für Filterabfragen. Sie können Bestellungen nicht einfach mit ?date=heute filtern — die Syntax ist deutlich ausführlicher:

searchCriteria — Bestellungen nach Datum filtern (Beispiel)
GET /rest/default/V1/orders ?searchCriteria[filter_groups][0][filters][0][field]=created_at &searchCriteria[filter_groups][0][filters][0][value]=2026-01-01 00:00:00 &searchCriteria[filter_groups][0][filters][0][condition_type]=gt &searchCriteria[filter_groups][1][filters][0][field]=status &searchCriteria[filter_groups][1][filters][0][value]=pending &searchCriteria[filter_groups][1][filters][0][condition_type]=eq &searchCriteria[pageSize]=50 &searchCriteria[currentPage]=1

Vollständige Troubleshooting-Matrix: Alle Fehlercodes auf einen Blick

Die folgende Tabelle dient als schnelle Referenz für alle Entwickler, die mit der Magento 2 REST API arbeiten. Bookmarken Sie sie für den täglichen Einsatz oder fügen Sie sie Ihrem internen Entwickler-Wiki hinzu.

HTTP-Code Magento-Bedeutung Häufigste Ursache Sofortmaßnahme Permanenter Fix
400 Bad Request JSON-Syntaxfehler, fehlendes Pflichtfeld, Typkonflikt Payload in lokalem Swagger validieren JSON-Lint im CI/CD-Pipeline integrieren
401 Unauthorized Admin-Token abgelaufen (4h), falsches Token Neuen Admin-Token generieren (temporär) Integration Token erstellen (permanent)
403 Forbidden ACL-Ressource nicht aktiviert Fehlermeldung lesen — zeigt fehlende Ressource Ressource in System > Integrationen aktivieren
404 Not Found Fehlender Store-Scope in der URL /rest/default/ oder /rest/all/ ergänzen URL-Builder-Funktion mit Scope als Parameter
405 Method Not Allowed Falsche HTTP-Methode (POST statt PUT etc.) Swagger-Dokumentation für korrekte Methode prüfen HTTP-Methoden per Endpoint-Konfiguration validieren
429 Too Many Requests Rate Limit überschritten Exponential Backoff implementieren Async Bulk API für Massenoperationen nutzen
500 Internal Server Error PHP-Absturz, Memory-Limit, Plugin-Konflikt, DB-Lock tail -f var/log/exception.log ausführen Memory-Limit erhöhen; Async API für Bulk-Ops
503 Service Unavailable Wartungsmodus aktiv bin/magento maintenance:status prüfen bin/magento maintenance:disable
504 Gateway Timeout Zu großer Payload, langsame DB-Query Payload in kleinere Batches aufteilen Async Bulk API; DB-Query optimieren
😩
Manuelle Fehlersuche ohne Monitoring

API-Fehler werden erst entdeckt, wenn Kunden sich beschweren. Keine Echtzeit-Alerts, kein zentrales Log-Monitoring, stundenlange Debugging-Sessions für Fehler, die in 5 Minuten lösbar wären — wenn man wüsste, wo man schaut.

🚀
Proaktives Monitoring mit ShippyPro

ShippyPro's vorgefertigte Magento-Integration enthält eingebaute Fehlerbehandlung, automatische Retry-Logik und Echtzeit-Benachrichtigungen bei Synchronisationsproblemen — über die Integrationsplattform vollständig konfigurierbar.

DSGVO-Konformität beim API-Logging in Deutschland

Für Entwickler im DACH-Raum gibt es einen wichtigen Aspekt, der in internationalen Magento-Guides oft fehlt: die DSGVO-Anforderungen an das API-Logging. Magento loggt standardmäßig vollständige Request-Payloads in var/log/debug.log. Diese Logs können personenbezogene Daten wie Kundennamen, E-Mail-Adressen und Lieferadressen enthalten. Das Speichern dieser Daten in Klartext-Logfiles ohne Löschfristen verstößt gegen Art. 5 DSGVO (Grundsatz der Speicherbegrenzung). Stellen Sie sicher, dass Debug-Logging in der Produktivumgebung deaktiviert ist (Stores > Konfiguration > Erweitert > Entwickler > Protokollierung), Logfiles Rotations- und Löschrichtlinien unterliegen und personenbezogene Daten in internen Logs pseudonymisiert oder geschwärzt werden. Informationen zu den Anforderungen finden Sie direkt beim Bundesbeauftragten für den Datenschutz und die Informationsfreiheit (BfDI).

Product

ShippyPro Integrationen

Vorgefertigte Magento 2 / Adobe Commerce Integration mit eingebauter Fehlerbehandlung, automatischer Retry-Logik und Echtzeit-Sync-Status-Monitoring.

Integrationen entdecken →
Product

KI-Versandautomatisierung

Automatisieren Sie Versand-Workflows direkt aus Magento 2 heraus — ohne manuelle API-Calls, ohne Fehleranfälligkeit durch hardcodierte Token.

Automatisierung ansehen →
API

ShippyPro API-Dokumentation

Vollständige technische Dokumentation der ShippyPro REST API — mit Code-Beispielen für die Magento 2 Integration, Webhooks und Bulk-Endpunkten.

Dokumentation öffnen →
Product

ShippyPro API-Zugang

Greifen Sie auf alle ShippyPro-Funktionen programmatisch zu — Versandlabels, Tracking, Retouren und Carrier-Auswahl über eine einheitliche REST API.

API-Zugang →
Support

Magento 2 Verbindungsleitfaden

Schritt-für-Schritt-Anleitung zur erstmaligen Verbindung Ihres Magento 2 Shops mit ShippyPro — inklusive Token-Konfiguration und ACL-Setup.

Leitfaden öffnen →
Hub

Ressourcen & Entwickler-Guides

Technische Leitfäden, Webinare und Best Practices für die ShippyPro-Integration in Magento, Shopify und weitere Plattformen.

Ressourcen ansehen →

Warum läuft mein Magento API-Token alle 4 Stunden ab?

Dies ist die Standard-Sicherheitseinstellung für Admin-User-Tokens in Magento 2. Das System geht davon aus, dass ein Mensch angemeldet ist, und begrenzt die Session entsprechend. Für automatisierte Skripte und externe Integrationen ist dieses Verfahren ungeeignet. Die korrekte Lösung ist die Erstellung einer Integration unter System > Erweiterungen > Integrationen. Integrationen verwenden OAuth-Logik und stellen Tokens aus, die nicht ablaufen, solange sie nicht manuell widerrufen werden. Erhöhen Sie niemals die Admin-Token-Lebensdauer in der Konfiguration — das ist ein Sicherheitsrisiko.

Wie filtere ich Bestellungen nach Datum über die Magento REST API?

Magento verwendet das searchCriteria-Format für alle Filterabfragen. Sie können nicht einfach ?date=heute anhängen. Der korrekte Query-String für Bestellungen nach dem 1. Januar 2026 lautet: searchCriteria[filter_groups][0][filters][0][field]=created_at, searchCriteria[filter_groups][0][filters][0][value]=2026-01-01 00:00:00 und searchCriteria[filter_groups][0][filters][0][condition_type]=gt. Das Konditionsattribut gt steht für „greater than" (größer als). Kombinieren Sie mehrere Filtergruppen für komplexere Abfragen.

Kann ich über die Magento API einen vollständigen Reindex anstoßen?

Technisch ist es möglich, aber in Produktivumgebungen nicht empfehlenswert. Ein vollständiger Reindex über die API während des laufenden Betriebs kann Datenbanktabellen blockieren und den Checkout für Kunden verlangsamen oder temporär unterbrechen. Best Practice ist es, Magento's interne Cron-Jobs die Indizierung im Hintergrund verwalten zu lassen (Einstellung „Bei Zeitplan aktualisieren" unter Stores > Konfiguration > Katalog > Katalog). Wenn ein manueller Reindex unbedingt notwendig ist, führen Sie ihn immer über SSH (bin/magento indexer:reindex) in Zeiten geringen Traffics durch.

Was ist der Unterschied zwischen der Standard REST API und der Async Bulk API in Magento?

Die Standard REST API verarbeitet Anfragen synchron: Sie senden eine Anfrage, Magento verarbeitet sie sofort und antwortet — was bei großen Datenmengen zu Timeouts und Memory-Abstürzen führen kann. Die Async Bulk API (/async/bulk/V1/...) nimmt die Anfrage an, legt sie in eine RabbitMQ-Warteschlange und antwortet sofort mit 202 Accepted — die eigentliche Verarbeitung erfolgt asynchron im Hintergrund. Für Massenoperationen wie Katalogaktualisierungen, Preisänderungen oder Versandstatus-Updates aus ShippyPro ist die Async Bulk API grundsätzlich vorzuziehen.

Wie verbinde ich meinen Magento 2 Shop mit ShippyPro ohne API-Fehler?

Die sicherste Methode ist die Verwendung der vorgefertigten ShippyPro-Integration aus den ShippyPro-Integrationen. Diese Integration erstellt automatisch eine korrekt konfigurierte Magento-Integration mit den minimal notwendigen ACL-Ressourcen und verwendet permanente Integration Tokens statt ablaufender Admin-Tokens. Für eine manuelle Integration folgen Sie dem Schritt-für-Schritt-Leitfaden im ShippyPro Help Center und stellen sicher, dass der Store-Scope korrekt auf /rest/default/ gesetzt ist.

Magento-Versand automatisieren — ohne API-Kopfschmerzen

Verbinden Sie Ihren Magento 2 Shop mit ShippyPro und lassen Sie unsere vorgefertigte Integration die gesamte API-Komplexität übernehmen — stabile Tokens, korrekte Scopes, automatische Fehlerbehandlung.

Kostenlos registrieren und Magento verbinden →

ShippyPro Product Team

Das Produktteam von ShippyPro hat sich der Entwicklung innovativer Technologien verschrieben, die es Unternehmen ermöglichen, ihre Versandabläufe zu vereinfachen. Durch die Kombination von Kundenforschung mit modernster Technologie entwickeln wir Funktionen, die die Effizienz steigern, den Aufwand reduzieren und die logistische Flexibilität erhöhen.