Fehler und Wiederholungen behandeln

Fehler tauchen an drei verschiedenen Stellen auf. Richte deine Behandlung danach aus, welche davon du gerade vor dir hast.

1. Anfragefehler (HTTP-Status + Envelope)

Validierung, Authentifizierung und Rate-Limits. Diese sind synchron, im Fehler-Envelope. Verzweige anhand von error.type für die Wiederholungsstrategie und anhand von error.code für Details. 429 → warte Retry-After ab; 5xx → exponentielles Backoff mit demselben Idempotency-Key.

2. Kanalfehler (die issues[] des Angebots)

Die Anfrage war in Ordnung, aber der Kanal hat das Angebot später abgelehnt, asynchron. Das Angebot wechselt zu status: "error", und issues[] enthält die eigene Meldung des Kanals als Klartext (z. B. „You are currently in a Shop probation period…“). Das sind Probleme des Verkäufers, keine API-Probleme: Zeig sie dem Händler.

Behebe zuerst die Ursache und wiederhole dann nur die Angebote, die mit genau diesem Fehler fehlschlagen. error_contains prüft die aktuelle Fehlermeldung des Angebots:

curl "https://api.nembol.com/rest/v1/listings?error_contains=item%20specific%20Brand" \
  -H "Authorization: Bearer $NEMBOL_API_KEY"

Wiederhole dann genau diese, bis zu 100 pro Aufruf:

curl -X POST https://api.nembol.com/rest/v1/listings/batch \
  -H "Authorization: Bearer $NEMBOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action": "retry",
       "items": [{"product_id": "prod_66a1f0", "channel_account_id": "chac_6aa12cab"}]}'

Angebote, die nicht mehr im Fehlerzustand sind, kommen als skipped (not_in_error) zurück. Eine veraltete Wiederholungsliste richtet also keinen Schaden an. Für ein einzelnes Angebot synchronisiert PATCH /listings/{id} mit {} es neu.

3. Teilergebnisse (Operationen)

Batch-Aufrufe liefern eine Operation, deren results[] pro Artikel/Kanal gelten. status: "partial" bedeutet, dass einige erfolgreich waren. Wiederhole nur die fehlgeschlagenen Einträge, nie blind den ganzen Batch.

Stolperfallen

• Nie blind wiederholen. Filtere nach dem genauen Fehler (error_contains, die fehlgeschlagenen results[]-Zeilen). Pauschale Wiederholungen aller Angebote im Fehlerzustand verstärken Probleme.
• Mit dem Idempotency-Key sind Wiederholungen kostenlos. Gleicher Key + gleiche Nutzlast = gespeicherte Antwort, keine doppelten Auswirkungen.
• Mit der Zeit werden unbekannte Codes auftauchen. Greif dann auf error.type zurück.
• request_id steht in jedem Fehler: Gib sie beim Support an.

Zuletzt aktualisiert am 20. Oktober 2026