Codes d'erreur

Maintenu par : Aether365 Team Public : Développeurs et administrateurs informatiques Périmètre : Référence complète des codes d'erreur de l'API Aether365

Toutes les erreurs API renvoient une structure JSON cohérente :

{
  "success": false,
  "error": {
    "code": "SNAKE_CASE_ERROR_CODE",
    "message": "Human-readable description",
    "details": {}
  }
}

Authentification

Code	HTTP	Signification	Solution
AUTH_MISSING_TOKEN	401	Pas d'en-tête Authorization dans la requête	Incluez Authorization: Bearer <token> dans chaque requête
AUTH_INVALID_TOKEN	401	Le JWT n'a pas pu être vérifié	Vérifiez que le jeton n'est pas mal formé ou tronqué
AUTH_EXPIRED_TOKEN	401	Le JWT a expiré	Obtenez un nouveau jeton en vous reconnectant ou en rafraîchissant la session
AUTH_INSUFFICIENT_SCOPE	403	Le compte authentifié n'a pas la permission pour cette action	Vérifiez que vous utilisez un compte avec le rôle requis

Autorisation

Code	HTTP	Signification	Solution
TENANT_ACCESS_DENIED	403	Tentative d'accès aux données d'un autre tenant	Ceci ne devrait jamais se produire en utilisation normale - contactez le support
AUTH_INSUFFICIENT_SCOPE	403	Permissions insuffisantes pour cette action	Vérifiez que vous utilisez un compte avec le rôle requis

Tenant

Code	HTTP	Signification	Solution
TENANT_NOT_FOUND	404	Aucun compte tenant n'existe pour cet utilisateur	Créez un compte sur app.aether365.io
TENANT_NOT_CONNECTED	400	Le consentement administrateur Microsoft 365 n'a pas été complété	Connectez un tenant via Paramètres > Connexions

Analyses

Code	HTTP	Signification	Solution
SCAN_NOT_FOUND	404	L'identifiant d'analyse n'existe pas ou appartient à un autre tenant	Vérifiez l'identifiant de l'analyse
SCAN_ALREADY_RUNNING	409	Une analyse est déjà en cours pour ce tenant	Attendez la fin de l'analyse en cours
SCAN_PLAN_LIMIT_REACHED	429	Quota d'analyses épuisé	Attendez la prochaine période de facturation ou contactez le support
SERVICE_UNAVAILABLE	503	La plateforme est en mode maintenance	Consultez le statut et réessayez une fois la maintenance terminée

Connexions

Code	HTTP	Signification	Solution
CONNECTION_NOT_FOUND	404	L'identifiant de connexion n'existe pas	Vérifiez l'identifiant de la connexion
CANNOT_REMOVE_LAST_CONNECTION	409	Impossible de supprimer la dernière connexion restante	Ajoutez une autre connexion avant de supprimer celle-ci

Membres de l'équipe

Code	HTTP	Signification	Solution
MEMBER_LIMIT_REACHED	429	Limite de membres atteinte	Contactez le support pour ajouter plus de membres
MEMBER_ALREADY_EXISTS	409	L'adresse e-mail a déjà une invitation active ou en attente	Vérifiez la liste actuelle des membres

Analyses programmées

Code	HTTP	Signification	Solution
SCAN_PLAN_LIMIT_REACHED	429	Limite de calendriers personnalisés atteinte	Supprimez un calendrier existant ou contactez le support

Validation

Code	HTTP	Signification
VALIDATION_ERROR	400	Le corps de la requête ou un paramètre de requête est invalide. Le champ details liste les champs invalides spécifiques.

Erreurs serveur

Code	HTTP	Signification	Solution
INTERNAL_ERROR	500	Erreur serveur inattendue	Réessayez la requête. Si l'erreur persiste, contactez le support avec l'identifiant de requête des en-têtes de réponse.

Limites de débit

Lorsque vous dépassez la limite de débit de l'API, l'API renvoie :

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Retry after 60 seconds."
  }
}

Statut HTTP : 429 Too Many Requests En-tête : Retry-After: 60

Limites de débit actuelles : 120 requêtes par minute par clé API.