Passer au contenu principal
L’API Qwoty utilise les codes de réponse HTTP conventionnels pour indiquer le succès ou l’échec d’une requête API. Cette page détaille comment gérer les erreurs efficacement et ce à quoi s’attendre dans les réponses d’erreur.

​
Codes de statut HTTP

L’API utilise les codes de statut HTTP standard pour indiquer le succès ou l’échec des requêtes :
  • 2xx Succès : la requête a réussi
  • 4xx Erreur client : la requête est invalide ou ne peut pas être traitée
  • 5xx Erreur serveur : une erreur interne du serveur s’est produite

​
Format de réponse d’erreur

Lorsqu’une erreur survient, l’API retourne une réponse JSON avec une propriété message contenant une description lisible de l’erreur : 
{
  "message": "The requested resource was not found"
}

​
Codes d’erreur courants

​
400 Bad Request

La requête est mal formée ou contient des paramètres invalides. Exemple : 
{
  "message": "Cannot assign a subscription to a customer without a currency set"
}

​
401 Unauthorized

La requête ne contient pas d’identifiants d’authentification valides. Exemple : 
{
  "message": "Missing authentication token"
}

​
404 Not Found

La ressource demandée n’a pas été trouvée. Exemple : 
{
  "message": "Product not found"
}

​
429 Too Many Requests

La limite de débit a été dépassée. Consultez la page Limitation de débit pour plus de détails.

​
Obtenir de l’aide

Si vous rencontrez une erreur que vous ne pouvez pas résoudre :
  1. Consultez le message d’erreur pour obtenir des indications
  2. Vérifiez le format et les paramètres de votre requête
  3. Assurez-vous que vos identifiants d’authentification sont valides
  4. Contactez notre équipe de support avec les détails de l’erreur et de la requête