Klantly Developers

Foutcodes

Elke fout komt terug als application/problem+json met een vaste, Engelse code. Hier staat per code wat er misging en hoe je het oplost.

De vorm van een fout

Een foutantwoord heeft altijd type, title, status en code. Bij validatiefouten staat per veld de melding in errors. Elk antwoord heeft een request_id: noem die als je support om hulp vraagt.

application/problem+json
{
  "type": "https://developers.klantly.com/errors/validation_failed",
  "title": "De invoer is ongeldig.",
  "status": 422,
  "code": "validation_failed",
  "detail": "1 veld is ongeldig.",
  "errors": {
    "email": [
      "Email moet een geldig e-mailadres zijn."
    ]
  },
  "request_id": "req_01j7zq3k9x2m4n6p8r0t2v4w6y"
}

Alle foutcodes

HTTP-status Code Betekenis
400 bad_request Ongeldig verzoek.
401 api_key_expired Deze API-sleutel is verlopen.
401 api_key_revoked Deze API-sleutel is ingetrokken.
401 invalid_api_key Ongeldige API-sleutel.
401 unauthenticated Authenticatie vereist.
403 account_suspended Het account van dit bedrijf is geblokkeerd.
403 feature_not_available Deze functie is niet beschikbaar voor dit bedrijf.
403 forbidden Geen toegang.
403 insufficient_scope Deze API-sleutel heeft geen toegang tot deze actie.
403 ip_not_allowed Dit IP-adres mag deze API-sleutel niet gebruiken.
403 limit_reached De limiet van het abonnement is bereikt.
403 subscription_inactive Dit bedrijf heeft geen actief abonnement.
404 not_found Niet gevonden.
405 method_not_allowed Deze methode is hier niet toegestaan.
409 conflict Dit botst met de huidige toestand.
409 idempotency_in_progress Een verzoek met deze Idempotency-Key is nog bezig.
409 invalid_state_transition Deze actie kan niet in de huidige status.
412 precondition_failed Het record is intussen gewijzigd.
413 payload_too_large De body van het verzoek is te groot.
415 unsupported_media_type Dit formaat wordt niet ondersteund.
422 idempotency_key_reused Deze Idempotency-Key is al gebruikt voor een ander verzoek.
422 unknown_field De invoer bevat een onbekend veld.
422 validation_failed De invoer is ongeldig.
429 rate_limited Te veel verzoeken.
500 server_error Er ging iets mis aan onze kant.
503 api_disabled De API is tijdelijk niet beschikbaar.