Gestion des erreurs

Toutes les erreurs renvoient un objet JSON contenant un champ error :

{ "error": "Demande non valide: dpeId is required" }

Certaines réponses incluent aussi un errorObject avec des détails supplémentaires (validation par champ, contexte interne, etc.).

Codes HTTP

Code	Signification
400	Requête invalide (paramètres manquants ou incorrects)
401	Clé partenaire invalide ou manquante — voir Authentification

Alertes de pré-analyse

L’endpoint /partners/dpe/pre peut renvoyer un tableau warnings. Trois types d’alertes :

Type	Action
block	Le DPE ne peut pas être traité (trop ancien, erreur dans le XML). Arrêtez le processus.
confirm	Normalisation recommandée. Relancez avec forceNormalization: true si l’utilisateur accepte.
warning	Information — pas bloquant, vous pouvez continuer.

Astuces

• En cas de block, affichez l’alerte à l’utilisateur et n’enchaînez pas sur l’initialisation/calcul — ils renverront aussi des erreurs.
• Loggez systématiquement le couple (customerId, userId, dpeId) pour faciliter le diagnostic côté Apihom si vous nous remontez un cas.