Codes d'Erreur
Liste complète des codes d'erreur de l'API, leurs significations et comment les gérer.
Codes de Statut HTTP
L'API RakuWP utilise les codes de statut HTTP standards pour indiquer le résultat d'une requête :
| Code | Signification | Quand Cela Se Produit |
|---|---|---|
200 | Succès | La requête a été traitée avec succès |
400 | Requête Incorrecte | Paramètres manquants ou invalides |
401 | Non Autorisé | Clé de licence invalide ou manquante |
403 | Interdit | La licence est expirée, suspendue ou révoquée |
404 | Non Trouvé | L'endpoint ou la ressource n'existe pas |
429 | Trop de Requêtes | Limite de taux dépassée |
500 | Erreur Serveur | Erreur inattendue côté serveur |
Format de Réponse d'Erreur
Toutes les réponses d'erreur suivent une structure JSON cohérente :
{
"success": false,
"error": "Message d'erreur lisible",
"code": "CODE_ERREUR"
}
Codes d'Erreur Courants
Erreurs de Licence
| Code | Description | Résolution |
|---|---|---|
LICENSE_INVALID | La clé de licence n'est pas reconnue | Vérifiez les fautes de frappe. Copiez la clé depuis le panneau. |
LICENSE_EXPIRED | La licence a expiré | Renouvelez votre abonnement depuis la page Facturation. |
LICENSE_SUSPENDED | La licence a été suspendue | Contactez le support pour assistance. |
SITE_LIMIT_REACHED | Nombre maximum de sites actifs atteint | Désactivez un site existant avant d'en ajouter un nouveau. |
SITE_NOT_REGISTERED | L'URL du site n'est pas enregistrée | Ajoutez l'URL de votre site dans le panneau avant l'activation. |
Erreurs de Requête
| Code | Description | Résolution |
|---|---|---|
MISSING_PARAMETER | Un champ obligatoire est manquant | Consultez la documentation API pour les champs requis. |
INVALID_URL | L'URL fournie n'est pas valide | Assurez-vous que l'URL du site inclut le protocole (https://). |
RATE_LIMITED | Trop de requêtes en peu de temps | Attendez et réessayez. Implémentez un backoff exponentiel. |
Gestion des Erreurs dans Votre Code
Vérifiez toujours le champ success dans la réponse avant de traiter les données. Enregistrez les réponses d'erreur pour le débogage. Le plugin gère la plupart des erreurs automatiquement, mais les intégrations personnalisées doivent implémenter une gestion d'erreurs appropriée.