Overview
L'API REST BroadNet signale les erreurs avec un code d'état HTTP standard et un corps JSON nommé ExceptionResponse, comportant cinq champs : status, error, message, errorCode et requestUri. La correspondance s'effectue d'abord sur le statut HTTP, puis sur errorCode. Exception : un jeton Bearer manquant ou invalide est rejeté plus tôt, au niveau de la passerelle API, avec un code 401 dont le corps ne contient que error et message.
Codes d'état
Le code 400 indique une erreur de validation ou un champ obligatoire manquant : corrigez la requête. Le code 401 indique que le jeton Bearer est manquant ou invalide, et le code 403 indique que l’opération est interdite : corrigez le jeton. Le code 500 indique une erreur serveur inattendue et le code 502 indique qu’un fournisseur en amont a rejeté l’appel : réessayez avec un délai exponentiel. Les liaisons SMPP renvoient les codes command_status SMPP standard.
Exemples
Copiez, collez, remplacez les valeurs d'exemple — ces exemples appellent l'API de production tels quels.
{
"status": 400,
"error": "Bad Request",
"message": "…",
"errorCode": "…",
"requestUri": "/sms/sendSms"
}{
"error": "Unauthorized",
"message": "Missing Authorization token"
}