Handling errors

Gestion des erreurs avec l'API Business Djamo

Convention

L'API Business Djamo utilise les codes de réponse HTTP conventionnels pour indiquer le succès ou l'échec d'une requête API.

En général :

2xx: Les codes dans cette plage indiquent que la requête a été bien reçue et est en cours de traitement.
4xx: Les codes dans cette plage indiquent un problème avec vos données en entrée (comme une erreur d'authentification ou de validation).
5xx: Les codes dans cette plage indiquent une erreur serveur. Ces erreurs devraient être rares. Si elles persistent, vous devez contacter l'équipe support technique de Djamo.

Erreurs HTTP

Vous trouverez ci-dessous la liste des erreurs HTTP que nous retournons actuellement.

Code HTTP	Description
`400`	Une erreur s'est produite lors du traitement de la requête.
`401`	La requête n'a pas pu être authentifiée. L'ACCESS_TOKEN est manquant ou incorrect.
`403`	L'ACCESS_TOKEN n'est pas autorisé à accéder à la ressource.
`404`	La ressource est introuvable.
`409`	Une collision s'est produite. Par exemple, vous avez utilisé la même référence deux fois pour créer deux transactions différentes.
`422`	Une erreur s'est produite lors du traitement. Si cela persiste, veuillez contacter Djamo.
`429`	La limite de débit a été dépassée. Le serveur a reçu trop de requêtes dans un laps de temps donné.
`500`	Une erreur serveur s'est produite. Si cela persiste, veuillez contacter Djamo.

Note

Notez que ces codes indiquent uniquement le statut de la requête HTTP et non le statut des transactions.

Réponse d'erreur

    {
  "statusCode": 400,
  "message": [
    "Error message"
  ],
  "error": "Bad Request Exception",
  "correlationId": "34f66c14821e8ba0e2d7749406c06081",
  "path": "/v1/xxx",
  "timestamp": "2025-10-30T08:35:51.624Z"
  }