Passer au contenu principal
L’API Hyperline utilise des codes de réponse HTTP conventionnels pour indiquer le succès ou l’échec d’une requête. Cette page détaille comment gérer efficacement les erreurs et à 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 était invalide ou ne peut ê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 renvoie 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 était mal formée ou contient des paramètres invalides. 
{
  "message": "Cannot assign a subscription to a customer without a currency set"
}
Les erreurs de validation courantes comprennent :
  • Champs obligatoires manquants
  • Valeurs de paramètres invalides

​
401 Unauthorized

La requête manque d’identifiants d’authentification valides. 
{
  "message": "Missing authentication token"
}

​
404 Not Found

La ressource demandée est introuvable. 
{
  "message": "Product not found"
}

​
429 Too Many Requests

La limite de débit des requêtes a été dépassée. Voir Limitation du débit pour plus de détails.

​
Obtenir de l’aide

Si vous rencontrez une erreur que vous ne parvenez pas à résoudre, veuillez :
  1. Consulter le message d’erreur pour obtenir des indications
  2. Vérifier le format et les paramètres de votre requête
  3. Vous assurer que vos identifiants d’authentification sont valides
  4. Contacter notre équipe de support avec les détails de l’erreur et les informations de la requête