MostlyQR

Fouten

De REST API gebruikt standaard HTTP-statuscodes en retourneert een JSON-foutobject:

json
{ "error": "unauthorized", "message": "Missing or invalid API key" }

# Statuscodes

Status error Wanneer
400 invalid-argument Misvormde body of een ontbrekend verplicht veld.
401 unauthorized Ontbrekende, ongeldige of ingetrokken API-sleutel.
403 forbidden / failed-precondition Buiten uw planentitlement (bijv. het minting van geserialiseerde codes zonder Enterprise, of boven een quota). De limiet staat in het bericht.
404 not-found Geen link/campagne/taak met die id, of niet eigendom van uw account.
429 rate-limited Snelheidslimiet per sleutel overschreden — wacht en probeer opnieuw.
5xx internal Er is iets aan onze kant misgegaan; veilig opnieuw proberen voor idempotente reads.

# Eigendom

Elke read en write is bereikt tot het account waarnaar de API-sleutel wordt omgezet. Het aanvragen van een link of campagne van een ander account retourneert 404 (niet 403) — we onthullen niet dat het bestaat.

# Asynchrone taken

Batch en geserialiseerde mint taken accepteren de aanvraag (200, queued), en oppervlakken fouten vervolgens in de taakstatus (status: "failed" met een reden), niet in het originele HTTP-antwoord. Poll altijd de taak.

# Verificatie

De openbare verificatie eindpunten geven nooit fouten voor een onbekende serienummer — ze retourneren status: "unknown" (een nep-/niet-uitgegeven code is een zinvol antwoord, geen 404).

# Volgende