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 :

CodeSignificationQuand Cela Se Produit
200SuccèsLa requête a été traitée avec succès
400Requête IncorrecteParamètres manquants ou invalides
401Non AutoriséClé de licence invalide ou manquante
403InterditLa licence est expirée, suspendue ou révoquée
404Non TrouvéL'endpoint ou la ressource n'existe pas
429Trop de RequêtesLimite de taux dépassée
500Erreur ServeurErreur 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

CodeDescriptionRésolution
LICENSE_INVALIDLa clé de licence n'est pas reconnueVérifiez les fautes de frappe. Copiez la clé depuis le panneau.
LICENSE_EXPIREDLa licence a expiréRenouvelez votre abonnement depuis la page Facturation.
LICENSE_SUSPENDEDLa licence a été suspendueContactez le support pour assistance.
SITE_LIMIT_REACHEDNombre maximum de sites actifs atteintDésactivez un site existant avant d'en ajouter un nouveau.
SITE_NOT_REGISTEREDL'URL du site n'est pas enregistréeAjoutez l'URL de votre site dans le panneau avant l'activation.

Erreurs de Requête

CodeDescriptionRésolution
MISSING_PARAMETERUn champ obligatoire est manquantConsultez la documentation API pour les champs requis.
INVALID_URLL'URL fournie n'est pas valideAssurez-vous que l'URL du site inclut le protocole (https://).
RATE_LIMITEDTrop de requêtes en peu de tempsAttendez 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.