Klantly Developers

Codes d'erreur

Chaque erreur est renvoyée en application/problem+json avec un code fixe, en anglais. Pour chaque code, vous trouverez ce qui s'est mal passé et comment le résoudre.

La forme d'une erreur

Une réponse d'erreur contient toujours type, title, status et code. Pour les erreurs de validation, errors indique le message par champ. Chaque réponse contient un request_id : indiquez-le lorsque vous demandez de l'aide au support.

application/problem+json
{
  "type": "https://developers.klantly.com/errors/validation_failed",
  "title": "Les données saisies ne sont pas valides.",
  "status": 422,
  "code": "validation_failed",
  "detail": "1 champ n'est pas valide.",
  "errors": {
    "email": [
      "Email doit être une adresse e-mail valide."
    ]
  },
  "request_id": "req_01j7zq3k9x2m4n6p8r0t2v4w6y"
}

Tous les codes d'erreur

Statut HTTP Code Signification
400 bad_request Requête invalide.
401 api_key_expired Cette clé API a expiré.
401 api_key_revoked Cette clé API a été révoquée.
401 invalid_api_key Clé API invalide.
401 unauthenticated Authentification requise.
403 account_suspended Le compte de cette entreprise est bloqué.
403 feature_not_available Cette fonctionnalité n'est pas disponible pour cette entreprise.
403 forbidden Accès refusé.
403 insufficient_scope Cette clé API n'a pas accès à cette action.
403 ip_not_allowed Cette adresse IP ne peut pas utiliser cette clé API.
403 limit_reached La limite de l'abonnement est atteinte.
403 subscription_inactive Cette entreprise n'a pas d'abonnement actif.
404 not_found Introuvable.
405 method_not_allowed Cette méthode n'est pas autorisée ici.
409 conflict Ceci est en conflit avec l'état actuel.
409 idempotency_in_progress Une requête avec cette Idempotency-Key est encore en cours.
409 invalid_state_transition Cette action n'est pas possible dans le statut actuel.
412 precondition_failed L'enregistrement a été modifié entre-temps.
413 payload_too_large Le corps de la requête est trop volumineux.
415 unsupported_media_type Ce format n'est pas pris en charge.
422 idempotency_key_reused Cette Idempotency-Key a déjà été utilisée pour une autre requête.
422 unknown_field Les données contiennent un champ inconnu.
422 validation_failed Les données saisies ne sont pas valides.
429 rate_limited Trop de requêtes.
500 server_error Un problème est survenu de notre côté.
503 api_disabled L'API est temporairement indisponible.