Codes d'erreur

L'API Daxium-Air utilise des codes d'erreur standardisés préfixés par DAERR- pour identifier les erreurs spécifiques. Chaque erreur retournée inclut un code HTTP approprié, un message descriptif et des informations contextuelles.

Format des réponses d'erreur

Toutes les erreurs suivent une structure JSON standardisée :

{
  "code": "DAERR-API1000",
  "message": "Invalid payload format",
  "url": "https://doc-dev.daxium-air.com/errors.html#DAERR-API1000",
  "api_version": "v1.3",
  "infos": [],
  "server_time": "1760616000"
}

Structure de la réponse

Codes d'erreur API

DAERR-API1000

HTTP 400 Bad Request

Message : Format de payload invalide

Cause : La requête contient un payload mal formé ou dont la structure ne correspond pas au format attendu.

Solution : Vérifiez que votre payload JSON est valide et correspond à la structure attendue par l'endpoint.

DAERR-API1001

HTTP 404 Not Found

Message : Utilisateur non trouvé

Cause : L'adresse email fournie ne correspond à aucun utilisateur dans le système.

Solution : Vérifiez l'adresse email et assurez-vous qu'elle correspond à un utilisateur existant.

DAERR-API1002

HTTP 404 Not Found

Message : Route non trouvée

Cause : L'endpoint demandé n'existe pas dans l'API.

Solution : Vérifiez l'URL de votre requête et consultez la documentation pour utiliser l'endpoint correct.

DAERR-API1003

HTTP 404 Not Found

Message : Structure non trouvée

Cause : La structure demandée n'existe pas ou n'est pas accessible avec vos permissions.

Solution : Vérifiez l'ID de la structure et assurez-vous d'avoir les permissions nécessaires.

Codes d'erreur d'authentification

DAERR-LOG013

HTTP 429 Too Many Requests

Message : Trop de tentatives de connexion

Cause : Le compte a été temporairement verrouillé suite à un nombre excessif de tentatives de connexion échouées.

Solution : Attendez quelques minutes avant de réessayer. Si le problème persiste, utilisez la fonctionnalité de réinitialisation de mot de passe.

DAERR-LOG014

HTTP 429 Too Many Requests

Message : Trop de demandes de réinitialisation de mot de passe

Cause : Un nombre excessif de demandes de réinitialisation de mot de passe a été détecté pour ce compte.

Solution : Attendez quelques minutes avant de soumettre une nouvelle demande.

Codes d'erreur SSO SAML

DAERR-SSO1000

HTTP 400 Bad Request

Message : Paramètre manquant

Cause : Un ou plusieurs paramètres requis sont absents de la requête SSO.

Solution : Vérifiez la documentation SSO et assurez-vous d'inclure tous les paramètres requis.

DAERR-SSO1001

HTTP 400 Bad Request

Message : ID client invalide

Cause : L'identifiant client fourni n'est pas valide ou n'existe pas.

Solution : Vérifiez votre configuration SSO et l'ID client fourni.

DAERR-SSO1002

HTTP 403 Forbidden

Message : Nom d'utilisateur vide

Cause : Le nom d'utilisateur n'a pas été fourni ou est vide.

Solution : Assurez-vous que le nom d'utilisateur est correctement transmis via le flux SSO.

DAERR-SSO1003

HTTP 403 Forbidden

Message : Utilisateur non trouvé

Cause : L'utilisateur n'existe pas dans le système.

Solution : Vérifiez que l'utilisateur existe et est correctement configuré pour l'authentification SSO.

DAERR-SSO1004

HTTP 403 Forbidden

Message : Utilisateur non autorisé

Cause : L'utilisateur existe mais n'a pas les permissions nécessaires pour accéder via SSO.

Solution : Contactez l'administrateur pour vérifier les permissions de l'utilisateur.

DAERR-SSO1005

HTTP 403 Forbidden

Message : URI de redirection invalide

Cause : L'URI de redirection fournie n'est pas autorisée pour cette application.

Solution : Vérifiez que l'URI de redirection est configurée dans les paramètres SSO de l'application.

DAERR-SSO1007

HTTP 400 Bad Request

Message : Requête de déconnexion invalide

Cause : La requête de déconnexion SAML n'est pas valide.

Solution : Vérifiez le format de la requête de déconnexion SAML.

DAERR-SSO1008

HTTP 400 Bad Request

Message : XML de déconnexion invalide

Cause : Le XML de la requête de déconnexion SAML est mal formé.

Solution : Assurez-vous que le XML de la requête de déconnexion respecte le standard SAML.

DAERR-SSO1009

HTTP 400 Bad Request

Message : ID de fournisseur SSO invalide

Cause : L'identifiant du fournisseur SSO n'est pas valide.

Solution : Vérifiez l'ID du fournisseur SSO dans votre configuration.

DAERR-SSO1010

HTTP 400 Bad Request

Message : Configuration SAML invalide

Cause : Les paramètres de configuration SAML sont incorrects ou incomplets.

Solution : Revoyez la configuration SAML et assurez-vous que tous les paramètres requis sont correctement définis.

DAERR-SSO1011

HTTP 404 Not Found

Message : Fournisseur invalide

Cause : Le fournisseur SSO spécifié n'existe pas.

Solution : Vérifiez que le fournisseur SSO est correctement configuré dans le système.

DAERR-SSO1012

HTTP 404 Not Found

Message : Utilisateur non trouvé lors de la déconnexion

Cause : L'utilisateur n'a pas pu être identifié lors de la tentative de déconnexion.

Solution : Vérifiez que l'utilisateur est bien connecté et que les informations de session sont valides.

Codes d'erreur SSO OpenID Connect

DAERR-SSO100

HTTP 400 Bad Request

Message : Utilisateur non trouvé (OpenID)

Cause : L'utilisateur OpenID Connect n'a pas été trouvé dans le système.

Solution : Vérifiez que l'utilisateur existe et que le mapping OpenID est correctement configuré.

DAERR-SSO101

HTTP 403 Forbidden

Message : Accès refusé (OpenID)

Cause : L'accès via OpenID Connect a été refusé.

Solution : Vérifiez les permissions et la configuration OpenID Connect de l'utilisateur.

DAERR-SSO102

HTTP 400 Bad Request

Message : Type de fournisseur incorrect

Cause : Le fournisseur n'est pas de type OpenID Connect.

Solution : Utilisez un fournisseur OpenID Connect valide.

DAERR-SSO103

HTTP 400 Bad Request

Message : IDP manquant

Cause : L'Identity Provider (IDP) n'est pas configuré.

Solution : Configurez un Identity Provider OpenID Connect valide.

DAERR-SSO104

HTTP 400 Bad Request

Message : Client ID manquant

Cause : Le Client ID OpenID Connect n'est pas configuré.

Solution : Ajoutez le Client ID dans la configuration OpenID Connect.

DAERR-SSO105

HTTP 400 Bad Request

Message : Client Secret manquant

Cause : Le Client Secret OpenID Connect n'est pas configuré.

Solution : Ajoutez le Client Secret dans la configuration OpenID Connect.

DAERR-SSO106

HTTP 400 Bad Request

Message : Erreur du fournisseur

Cause : Le fournisseur OpenID Connect a retourné une erreur.

Solution : Consultez les logs du fournisseur OpenID Connect pour plus de détails sur l'erreur.

DAERR-SSO107

HTTP 404 Not Found

Message : Fournisseur non trouvé

Cause : Le fournisseur OpenID Connect spécifié n'existe pas.

Solution : Vérifiez l'identifiant du fournisseur dans votre configuration.

DAERR-SSO108

HTTP 400 Bad Request

Message : Nom d'utilisateur invalide

Cause : Le nom d'utilisateur reçu du fournisseur OpenID Connect n'est pas valide.

Solution : Vérifiez le mapping des attributs OpenID Connect et assurez-vous que le claim username est correctement configuré.

Codes d'erreur de filtres

DAERR-FIL1000

HTTP 500 Internal Server Error

Message : Erreur générique de filtre

Cause : Une erreur générique s'est produite lors du traitement du filtre.

Solution : Vérifiez la structure de votre filtre et contactez le support si le problème persiste.

DAERR-FIL1001

HTTP 400 Bad Request

Message : Mauvaise combinaison de métadonnées

Cause : Les métadonnées du filtre contiennent une combinaison invalide de paramètres.

Solution : Revoyez la structure de vos métadonnées et assurez-vous qu'elles respectent les règles de combinaison.

DAERR-FIL1002

HTTP 400 Bad Request

Message : Mauvaise combinaison de paramètres

Cause : Les paramètres du filtre contiennent une combinaison invalide.

Solution : Vérifiez que vos paramètres respectent les combinaisons autorisées.

DAERR-FIL1003

HTTP 400 Bad Request

Message : Valeur nulle et "égal à" non autorisés

Cause : Vous ne pouvez pas utiliser l'opérateur "égal à" avec une valeur nulle.

Solution : Utilisez l'opérateur "est vide" pour tester les valeurs nulles.

DAERR-FIL1004

HTTP 400 Bad Request

Message : Valeur nulle et "différent de" non autorisés

Cause : Vous ne pouvez pas utiliser l'opérateur "différent de" avec une valeur nulle.

Solution : Utilisez l'opérateur "n'est pas vide" pour tester les valeurs non-nulles.

DAERR-FIL1005

HTTP 400 Bad Request

Message : Champ manquant dans le critère

Cause : Un critère de filtre ne contient pas de champ.

Solution : Ajoutez un champ valide à chaque critère de votre filtre.

DAERR-FIL1006

HTTP 400 Bad Request

Message : Champ manquant

Cause : Le champ spécifié est manquant dans la requête de filtre.

Solution : Ajoutez le champ requis dans votre filtre.

DAERR-FIL1007

HTTP 400 Bad Request

Message : Type de métadonnée incorrect

Cause : Le type de la métadonnée ne correspond pas au type attendu.

Solution : Vérifiez le type des métadonnées dans votre filtre.

DAERR-FIL1008

HTTP 400 Bad Request

Message : Type de paramètre incorrect

Cause : Le type du paramètre ne correspond pas au type attendu.

Solution : Corrigez le type du paramètre dans votre filtre.

DAERR-FIL1009

HTTP 400 Bad Request

Message : Opérateur non autorisé pour la métadonnée

Cause : L'opérateur utilisé n'est pas compatible avec ce type de métadonnée.

Solution : Consultez la documentation des opérateurs autorisés pour ce type de métadonnée.

DAERR-FIL1010

HTTP 400 Bad Request

Message : Opérateur non autorisé pour le paramètre

Cause : L'opérateur utilisé n'est pas compatible avec ce type de paramètre.

Solution : Utilisez un opérateur compatible avec le type de paramètre.

DAERR-FIL1011

HTTP 400 Bad Request

Message : Structure manquante

Cause : Le filtre nécessite une structure mais celle-ci n'est pas spécifiée.

Solution : Ajoutez une référence de structure dans votre filtre.

DAERR-FIL1012

HTTP 400 Bad Request

Message : Type d'entité non supporté

Cause : Le type d'entité spécifié n'est pas supporté pour le filtrage.

Solution : Utilisez un type d'entité supporté par le système de filtrage.

DAERR-FIL1013

HTTP 400 Bad Request

Message : JSON invalide

Cause : Le JSON du filtre est mal formé.

Solution : Validez la syntaxe JSON de votre filtre.

DAERR-FIL1014

HTTP 400 Bad Request

Message : Type de champ incorrect

Cause : Le type du champ ne correspond pas au type attendu.

Solution : Vérifiez le type du champ dans la structure et adaptez votre filtre.

DAERR-FIL1015

HTTP 400 Bad Request

Message : UUID dupliqué

Cause : Un UUID est utilisé plusieurs fois dans le filtre.

Solution : Assurez-vous que chaque UUID est unique dans votre filtre.

DAERR-FIL1016

HTTP 400 Bad Request

Message : UUID référencé inexistant

Cause : Un UUID référencé dans le filtre n'existe pas.

Solution : Vérifiez que tous les UUIDs référencés existent dans votre filtre.

DAERR-FIL1017

HTTP 400 Bad Request

Message : Champ inexistant

Cause : Le champ spécifié n'existe pas dans la structure.

Solution : Utilisez un champ existant dans la structure ciblée.

DAERR-FIL1018

HTTP 400 Bad Request

Message : Composition manquante

Cause : La composition du filtre est manquante ou incomplète.

Solution : Ajoutez une composition valide à votre filtre.

DAERR-FIL1019

HTTP 400 Bad Request

Message : Identifiant inexistant

Cause : L'identifiant spécifié n'existe pas.

Solution : Utilisez un identifiant valide et existant.

DAERR-FIL1020

HTTP 400 Bad Request

Message : Opérateur de composition inexistant

Cause : L'opérateur de composition (AND/OR) n'est pas reconnu.

Solution : Utilisez uniquement les opérateurs de composition valides (AND, OR).

DAERR-FIL1021

HTTP 400 Bad Request

Message : Nom de métadonnée inexistant

Cause : Le nom de métadonnée spécifié n'existe pas.

Solution : Utilisez un nom de métadonnée valide.

DAERR-FIL1022

HTTP 400 Bad Request

Message : Mauvaise combinaison exhaustive

Cause : Les paramètres exhaustifs du filtre contiennent une combinaison invalide.

Solution : Revoyez la configuration des paramètres exhaustifs.

DAERR-FIL1023

HTTP 400 Bad Request

Message : Champ manquant dans le tri par paramètre

Cause : Un champ est manquant dans la clause ORDER BY sur un paramètre.

Solution : Ajoutez le champ requis dans votre clause de tri.

DAERR-FIL1024

HTTP 400 Bad Request

Message : Champ manquant dans le tri par métadonnée

Cause : Un champ est manquant dans la clause ORDER BY sur une métadonnée.

Solution : Ajoutez le champ requis dans votre clause de tri.

DAERR-FIL1025

HTTP 400 Bad Request

Message : Ordre de tri inexistant

Cause : L'ordre de tri spécifié n'est pas valide.

Solution : Utilisez "ASC" ou "DESC" pour l'ordre de tri.

DAERR-FIL1026

HTTP 400 Bad Request

Message : Champ manquant dans le tri

Cause : Le champ de tri est manquant dans la clause ORDER BY.

Solution : Spécifiez un champ pour le tri.