Ga naar de hoofdinhoud
- Foutafhandeling

API-fouten

Elke API-fout retourneert een JSON-foutenvelop met een stabiele code, HTTP-status, bericht en request id voor de ondersteuning.

Fout-envelop

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

Vermeld de request id wanneer u contact opneemt met de ondersteuning.

Veelvoorkomende foutcodes

HTTPCodeBetekenis
400invalid_requestOngeldige JSON of ontbrekend veld.
400idempotency_key_requiredSchrijfverzoek zonder Idempotency-Key.
401unauthorizedOntbrekend, ongeldig, onbekend of ingetrokken token.
402plan_requiredAPI-toegang is niet geactiveerd voor de shop.
404asset_not_found, mapping_not_found, order_not_found, category_not_found, job_not_foundDe resource ontbreekt of hoort bij een andere shop.
409idempotency_conflictDezelfde sleutel is hergebruikt met een ander verzoek.
409stamping_in_progressOpnieuw verzenden is geblokkeerd zolang het PDF-stempelen nog loopt.
409delivery_not_yet_releasedVoor het product is een vertraagde downloadlevering ingesteld en de bestanden van de koper zijn nog niet vrijgegeven. error.details.release_at is het ISO 8601-tijdstip waarop ze vrijkomen; de merchant kan de bestelling eerder vrijgeven met het grant-downloads-endpoint.
422storage_quota_exceededDe upload of import zou de opslagquota overschrijden.
422key_limit_reachedDe shop heeft al het maximum van 25 actieve API-sleutels; trek er eerst een in.
422withdrawal_consent_requiredDe shop heeft toestemming voor het EU-herroepingsrecht ingeschakeld en de bestelling heeft nog geen toestemmingsrecord; download-URL's worden uitgegeven zodra de klant toestemming geeft.
429rate_limitedDe limiet voor API-sleutels of het opnieuw verzenden van bestellingen is bereikt.
500internal_errorOnverwachte serverfout.

API-documentatie

Was dit nuttig?

Nog vastgelopen? Mail admin@alvaapps.com.

Laatst bijgewerkt 2026-06-05