Concepts clés
| Concept | Description |
|---|---|
| DPE ID | Numéro ADEME du diagnostic (format : 2575E3361224X) |
| customerId | Votre identifiant client (compte/agence côté partenaire) |
| userId | Identifiant de l’utilisateur final côté partenaire |
| editablesChanges | Liste des travaux à simuler (isolation, fenêtres, chauffage, etc.) |
| referenceId | Identifiant d’un élément du DPE (ex : mur:0, baie_vitree:1) |
| Classe DPE | De A (très performant) à G (très énergivore) |
DPE ID
Section titled “DPE ID”Tout DPE est identifié par son numéro ADEME, au format <4 chiffres>E<7 chiffres><1 lettre>. Ce numéro est la clé d’entrée de toute l’API : la
pré-analyse, l’initialisation de la simulation, le calcul, etc. tournent
tous autour d’un DPE ID.
customerId, userId
Section titled “customerId, userId”Côté partenaire, vous identifiez vos clients (customerId) et leurs
utilisateurs (userId). Ces identifiants sont opaques pour Apihom :
nous ne validons pas leur format, ils servent uniquement à rapprocher les
données entre vos systèmes et les nôtres (logs, facturation, audit).
editablesChanges + referenceId
Section titled “editablesChanges + referenceId”Chaque élément modifiable du DPE (un mur, une baie vitrée, un système de
chauffage…) a un referenceId stable. Pour simuler des travaux, vous
envoyez un tableau d’editablesChanges qui dit, pour chaque
referenceId, quelle valeur substituer (ex. remplacer l’isolation
existante d’un mur, ou changer le type de fenêtre).
La liste des referenceId disponibles vient de l’appel
/partners/dpe/initial.
Classe DPE
Section titled “Classe DPE”Étiquette officielle de A à G, mesurant à la fois la performance énergétique et l’impact climat (CO₂) du logement. L’API renvoie la classe avant et après travaux pour chaque calcul.