Réponses

Type de contenu

L'API répond avec Type de contenu réglé sur application/json, et avec un contenu JSON dans le corps.

Codes de réponse

En cas de succès, le code d'état HTTP est normalement 200 et le contenu contient le résultat selon la nature de la requête. En cas d'erreur, il existe plusieurs codes d'état HTTP pour différents types d'erreurs.

• 200 OK

  • Réponse de succès. Le contenu contient le résultat selon la nature de la requête.

• 400 Bad Request

  • Erreur causée par l'application cliente, par ex. en cas de requête mal formée ou de charge utile invalide. Dans la plupart des cas, une telle erreur signifie un bug dans l'application cliente (consommatrice de l'API).

• 401 Unauthorized

  • Erreur due à l'utilisation d'une clé API et/ou d'un secret invalides, ou vous pouvez ne pas avoir la permission nécessaire pour utiliser le point de terminaison.

• 403 Forbidden

  • Erreur côté serveur qui doit être signalée à l'utilisateur final de l'application cliente. Se produit par exemple lorsque la validation côté serveur échoue ou lorsqu'une vérification de la logique métier est violée.

• 404 Not found

  • Le serveur ne peut pas trouver la ressource demandée par l'application cliente. Vérifiez l'URL et la méthode de la requête.

• 429 Too Many Requests

  • Erreur causée par trop de requêtes envoyées dans un laps de temps donné.

• 500 Internal Server Error et autres 5xx codes de réponse

  • Erreur inattendue du côté de l'API Fullwhere. Cela peut être dû à une défaillance logicielle. Si une telle situation se produit, l'erreur sera enregistrée et l'équipe de développement en sera informée.