Codes d'erreur

Liste des codes d'erreur de l'API JunkMail

Format des erreurs

Toutes les erreurs suivent ce format :

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Description de l'erreur",
    "details": {}
  }
}

Codes HTTP

Code	Signification
200	Succès
201	Ressource créée
400	Requête invalide
401	Non authentifié
403	Accès interdit
404	Ressource non trouvée
429	Trop de requêtes
500	Erreur serveur

---

Erreurs d'authentification

INVALID_API_KEY

{
  "code": "INVALID_API_KEY",
  "message": "La clé API est invalide ou expirée"
}

Solution : Vérifiez que votre clé API est correcte et active.

MISSING_API_KEY

{
  "code": "MISSING_API_KEY",
  "message": "Aucune clé API fournie"
}

Solution : Ajoutez le header Authorization: Bearer jm_live_xxxx.

INSUFFICIENT_SCOPE

{
  "code": "INSUFFICIENT_SCOPE",
  "message": "Cette action nécessite le scope 'emails:write'",
  "details": {
    "requiredScopes": ["emails:write"],
    "providedScopes": ["emails:read"]
  }
}

Solution : Créez une nouvelle clé API avec les scopes nécessaires.

---

Erreurs de validation

VALIDATION_ERROR

{
  "code": "VALIDATION_ERROR",
  "message": "Erreur de validation",
  "details": {
    "fields": {
      "alias": "L'alias doit contenir entre 3 et 30 caractères"
    }
  }
}

ALIAS_TAKEN

{
  "code": "ALIAS_TAKEN",
  "message": "Cet alias est déjà utilisé"
}

INVALID_DOMAIN

{
  "code": "INVALID_DOMAIN",
  "message": "Ce domaine n'est pas configuré pour votre compte"
}

---

Erreurs de ressources

RESOURCE_NOT_FOUND

{
  "code": "RESOURCE_NOT_FOUND",
  "message": "Adresse non trouvée",
  "details": {
    "resourceType": "address",
    "resourceId": "addr_invalid"
  }
}

ADDRESS_EXPIRED

{
  "code": "ADDRESS_EXPIRED",
  "message": "Cette adresse a expiré"
}

---

Erreurs de limite

RATE_LIMIT_EXCEEDED

{
  "code": "RATE_LIMIT_EXCEEDED",
  "message": "Limite de requêtes atteinte",
  "details": {
    "limit": 100,
    "resetAt": "2024-01-16T14:35:00Z"
  }
}

Solution : Attendez le reset ou réduisez la fréquence de vos requêtes.

QUOTA_EXCEEDED

{
  "code": "QUOTA_EXCEEDED",
  "message": "Limite d'adresses atteinte pour votre plan",
  "details": {
    "limit": 10,
    "current": 10
  }
}

Solution : Supprimez des adresses existantes ou passez à un plan supérieur.

---

Erreurs serveur

INTERNAL_ERROR

{
  "code": "INTERNAL_ERROR",
  "message": "Une erreur interne s'est produite"
}

Solution : Réessayez la requête. Si le problème persiste, contactez le support.

SERVICE_UNAVAILABLE

{
  "code": "SERVICE_UNAVAILABLE",
  "message": "Le service est temporairement indisponible"
}

Solution : Réessayez dans quelques minutes.