Gestion des erreurs

Les API flu.lu utilisent des codes de statut HTTP standards et des messages d’erreur applicatifs pour indiquer le succès ou l’échec d’une requête.

Structure des réponses d’erreur applicatives

Lorsqu’une erreur spécifique à l’application se produit, le corps de la réponse contiendra des détails utiles pour comprendre le problème :

{
  "error_code": "codice_univoco",
  "message": "Message descriptif de l’erreur"
}

Exemples d’erreurs applicatives courantes

Paramètre manquant

{
  "error_code": "missing_parameter",
  "message": "Le paramètre 'url' est obligatoire et absent de la requête."
}

Shortcode non valide

{
  "error_code": "invalid_shortcode",
  "message": "Le shortcode spécifié n’est pas valide ou n’existe pas."
}

Lien déjà existant

{
  "error_code": "link_already_exists",
  "message": "Le lien que vous avez essayé de créer existe déjà."
}

Quota maximale atteinte

{
  "error_code": "quota_reached",
  "message": "Vous avez atteint le nombre maximum de liens raccourcis autorisés par votre plan."
}

Erreur interne générique

{
  "error_code": "internal_error",
  "message": "Une erreur interne s’est produite, veuillez réessayer plus tard ou contacter le support."
}