Accès aux API ADEME

Accès aux API de l'ADEME

Cette page explique comment obtenir des identifiants pour l'API externe de l'ADEME, puis comment récupérer un DPE au format JSON ou XML.

1. Obtenir les accès

1. Créez un compte sur le portail développeur de l'ADEME (Anypoint Exchange) : 👉 https://eu1.anypoint.mulesoft.com/exchange/portals/ademe/

2. Connectez-vous, puis recherchez l'API x-ademe-externe-api.

3. Cliquez sur Request access et remplissez le formulaire :

   Champ	Valeur à choisir
   API instance	PRD
   Application	Create new application
   SLA Tier	operat-SLA

4. Récupérez vos identifiants : ils apparaissent dans la fiche de l'application que vous venez de créer.

⏳ Délai de validation : la demande d'accès est validée par l'ADEME. Les identifiants ne fonctionnent qu'une fois cette validation obtenue, ce qui peut prendre un certain temps.

2. Récupérer un DPE

L'API propose deux formats de réponse. Dans les exemples ci-dessous, 2278E2989821E est le numéro du DPE.

Format	Endpoint
JSON	GET https://api-externe.ademe.fr/api/v1/pub/dpe/2278E2989821E
XML	GET https://api-externe.ademe.fr/api/v1/pub/dpe/2278E2989821E/xml

3. JSON ou XML : quelles différences ?

Les deux endpoints ne se distinguent pas uniquement par leur format. Ils ne renvoient pas non plus les mêmes données :

• XML : une photographie du DPE. Le document correspond exactement au DPE tel qu'il a été généré. Ses valeurs ne sont jamais mises à jour par la suite. Par exemple, une révision des coefficients de conversion du chauffage ou de l'électricité n'entraîne pas de nouveau calcul.
• JSON : des données à jour. Les valeurs tiennent compte des dernières évolutions réglementaires, notamment des nouveaux coefficients.

💡 Quel format choisir ?

• XML pour retrouver le DPE d'origine, par exemple pour rejouer le calcul avec le moteur Open3CL et le comparer au résultat initial.
• JSON pour obtenir les valeurs actuelles du DPE.