Référence
Gestion des erreurs
Codes d’erreur normalisés et conduite à tenir.
Toutes les erreurs ont la même forme :
json
{ "success": false, "error": { "code": "LICENSE_EXPIRED", "message": "La licence a expiré." }, "nonce": "…", "server_time": "…" }| Code | HTTP | Signification et action |
|---|---|---|
INVALID_APPLICATION | 403 | Application inconnue ou archivée : vérifiez application_id. |
INVALID_LICENSE | 403 | Clé inexistante, d’une autre application ou mal formée (réponses identiques). |
LICENSE_EXPIRED | 403 | Licence expirée : proposez un renouvellement. |
LICENSE_REVOKED | 403 | Licence révoquée définitivement. |
LICENSE_SUSPENDED | 403 | Licence suspendue (réversible). |
DEVICE_LIMIT_REACHED | 409 | Plus d’appareils disponibles : l’utilisateur doit en libérer un. |
ACTIVATION_LIMIT_REACHED | 409 | Quota total d’activations consommé. |
DEVICE_BLOCKED | 403 | Appareil bloqué par l’éditeur. |
NOT_ACTIVATED | 403 | Licence non activée sur cet appareil (validation par clé). |
USER_BANNED | 403 | Titulaire banni par l’éditeur. |
APPLICATION_DISABLED | 403 | Application ou organisation désactivée. |
APPLICATION_MAINTENANCE | 503 | Maintenance : afficher le message renvoyé. |
VERSION_NOT_ALLOWED | 426 | Version inférieure au minimum : proposer la mise à jour. |
ACTIVATIONS_DISABLED | 403 | Nouvelles activations fermées temporairement. |
SESSION_EXPIRED | 401 | Session expirée ou révoquée : réactiver. |
SESSION_LIMIT_REACHED | 409 | Trop de sessions simultanées (stratégie « refuser »). |
RATE_LIMITED | 429 | Trop de requêtes ou trop de clés invalides : respecter Retry-After. |
VALIDATION_ERROR | 400 | Requête invalide (champ manquant ou mal formé). |
Les messages sont génériques par conception : ils ne révèlent jamais l’existence d’une clé ou d’une ressource. Basez la logique de votre logiciel sur code, pas sur message.