Zum Hauptinhalt springen
- Fehlerbehandlung

API-Fehler

Jeder API-Fehler gibt einen JSON-Fehlerumschlag mit einem stabilen Code, HTTP-Status, einer Meldung und einer request_id für den Support zurück.

Fehler-Envelope

{
  "error": {
    "code": "asset_not_found",
    "message": "No asset with id 42 for this shop",
    "status": 404,
    "request_id": "req_..."
  }
}

Geben Sie die request_id an, wenn Sie den Support kontaktieren.

Häufige Fehlercodes

HTTPCodeBedeutung
400invalid_requestFehlerhaftes JSON oder fehlendes Feld.
400idempotency_key_requiredSchreibanfrage ohne Idempotency-Key.
401unauthorizedFehlendes, ungültiges, unbekanntes oder widerrufenes Token.
402plan_requiredDer API-Zugriff wurde für den Shop nicht aktiviert.
404asset_not_found, mapping_not_found, order_not_found, category_not_found, job_not_foundDie Ressource fehlt oder gehört zu einem anderen Shop.
409idempotency_conflictDerselbe Schlüssel wurde mit einer anderen Anfrage wiederverwendet.
409stamping_in_progressDer erneute Versand ist blockiert, solange die PDF-Stempelung aussteht.
409delivery_not_yet_releasedFür das Produkt ist eine verzögerte Download-Auslieferung konfiguriert, und die Dateien des Käufers sind noch nicht freigeschaltet. error.details.release_at ist der ISO-8601-Zeitpunkt der Freischaltung; der Händler kann die Bestellung mit dem Endpunkt grant-downloads vorzeitig freigeben.
422storage_quota_exceededDer Upload oder Import würde das Speicherkontingent überschreiten.
422key_limit_reachedDer Shop hat bereits das Maximum von 25 aktiven API-Schlüsseln; widerrufen Sie zuerst einen.
422withdrawal_consent_requiredFür den Shop ist die EU-Widerrufsrecht-Einwilligung aktiviert und für die Bestellung liegt noch kein Einwilligungsnachweis vor; Download-URLs werden ausgegeben, sobald der Kunde einwilligt.
429rate_limitedDas Limit für API-Schlüssel oder erneute Bestellversände wurde erreicht.
500internal_errorUnerwarteter Serverfehler.

API-Dokumentation

War das hilfreich?

Immer noch nicht weiter? Schreiben Sie an admin@alvaapps.com.

Zuletzt aktualisiert 2026-06-05