Cette documentation a pour but de décrire les possibilités de l’API (web service) et leurs spécificités.
Cliquez ici pour accéder la version 2.1 du API.
Le web service retourne un fichier XML ou JSON avec au moins un code (erreur ou succès) et un message descriptif. Prérequis:
Récupérer le nombre courant de crédits API actifs sur votre compte
format | string Default: "xml" Enum: "xml" "json" Format de réponse |
<?php $email = 'ABC'; $token = 'XYZ'; $URL = 'https://www.ernmt-officiel.com/api/v3/credits/actifs'; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL,$URL); curl_setopt($ch, CURLOPT_RETURNTRANSFER,1); curl_setopt($ch, CURLOPT_USERPWD, "$email:$token"); $result = curl_exec ($ch); $status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE); //get status code curl_close ($ch); echo $result;
<?xml version="1.0" encoding="UTF-8"?> <data> <result>succès</result> <creditsActifs>15</creditsActifs> </data>
Utiliser une liste d'adresses pour récupérer leur coordonnées
format | string Default: "xml" Enum: "xml" "json" Format de réponse |
Liste des adresses
adresses required | Array of strings Liste des adresses |
{- "adresses": [
- "3 place du grand pavois 94000 Créteil",
- "1 Quai d’Anjou 75004 Paris"
]
}
<?xml version="1.0" encoding="UTF-8"?> <data> <result>succès</result> <code>200</code> <datas> <item0> <result>succès</result> <adresse>3 place du grand pavois 94000 Creteil</adresse> <lat>48.786472</lat> <long>2.4458</long> <cadastreId>94028000BG161</cadastreId> </item0> <item1> <result>succès</result> <adresse>1 Quai d’Anjou 75004 Paris</adresse> <lat>48.850962</lat> <long>2.360017</long> <cadastreId>75104000AU53</cadastreId> </item1> </datas> </data>
Utiliser une liste de cadastres pour récupérer leur coordonnées
format | string Default: "xml" Enum: "xml" "json" Format de réponse |
Liste des cadastres
required | Array of Code postal & Ville (object) or Insee (object) or CadastreId (object) Liste des parcelles |
{- "parcelles": [
- {
- "code_postal": "01330",
- "ville": "VILLARS LES DOMBES",
- "prefix": "000",
- "section": "AA",
- "numero": 14
}, - {
- "insee": "01443",
- "prefix": "000",
- "section": "AA",
- "numero": 15
}, - {
- "cadastreId": "01443000AA0016"
}
]
}
<?xml version="1.0" encoding="UTF-8"?> <data> <result>succès</result> <code>200</code> <datas> <item0> <result>succès</result> <adresse>3 place du grand pavois 94000 Creteil</adresse> <lat>48.786472</lat> <long>2.4458</long> <cadastreId>94028000BG161</cadastreId> </item0> <item1> <result>succès</result> <adresse>1 Quai d’Anjou 75004 Paris</adresse> <lat>48.850962</lat> <long>2.360017</long> <cadastreId>75104000AU53</cadastreId> </item1> </datas> </data>
Utiliser une liste d'adresses pour créer les rapports ERP ou ENSA
format | string Default: "xml" Enum: "xml" "json" Format de réponse |
Liste des adresses
Array of objects Liste des rapports commandés par adresse |
{- "rapports": [
- {
- "adresse": "3 place du grand pavois 94000 Créteil",
- "vendeur_nom": "Lavigne",
- "vendeur_prenom": "Jules",
- "acheteur_nom": "Dupont",
- "acheteur_prenom": "Louise",
- "adresse_titre": "11 Avenue Marcel Journet",
- "document_titre": "Residence 11 Avenue Marcel Journet 06370 Mouans-Sartoux",
- "ref_interne": "Lot N°2",
- "type": 1,
- "transaction_type": 1,
- "surveillance": 1,
- "conclusions_format": 1,
- "erp_type": 1
}
]
}
<?xml version="1.0" encoding="UTF-8"?> <data> <result>succès</result> <code>200</code> <datas> <item0> <result>succès</result> <adresse>8 Avenue du Château 94300 Vincennes</adresse> <pdf_name>https://www.ernmt-officiel.com/front/images/uploads/files/ernmt/API/28494/ERP_975091_20220119.pdf?t=1642621382</pdf_name> <ref>2014847</ref> <conclusions>Plans de Prévention des Risques : - Naturels : aucun - Miniers : aucun - Technologiques : aucun Radon de niveau 1, Séisme de niveau 1 ENSA : aucune nuisance aérienne n'a été identifiée sur le bien. Pollution des sols sur un rayon de 500m (BASIAS, BASOL, ICPE) : 69 sites. </conclusions> </item0> <item1> <result>succès</result> <adresse>3 place du grand pavois 94000 Creteil</adresse> <pdf_name>https://www.ernmt-officiel.com/front/images/uploads/files/ernmt/API/28494/ERP_975092_20220119.pdf?t=1642621384</pdf_name> <ref>2014848</ref> <conclusions>Plans de Prévention des Risques : - Naturels : inondation, mouvements de terrain - Miniers : aucun - Technologiques : aucun Radon de niveau 1, Séisme de niveau 1 ENSA : aucune nuisance aérienne n'a été identifiée sur le bien. Pollution des sols sur un rayon de 500m (BASIAS, BASOL, ICPE) : 18 sites. </conclusions> </item1> </datas> </data>
Utiliser une liste de parcelles pour créer les rapports ERP ou ENSA
format | string Default: "xml" Enum: "xml" "json" Format de réponse |
Liste des parcelles
Array of objects Liste des rapports commandés par parcelle |
{- "rapports": [
- {
- "parcelles": [
- {
- "code_postal": "01330",
- "ville": "VILLARS LES DOMBES",
- "prefix": "000",
- "section": "AA",
- "numero": 14
}, - {
- "insee": "01443",
- "prefix": "000",
- "section": "AA",
- "numero": 15
}, - {
- "cadastreId": "01443000AA0016"
}
], - "vendeur_nom": "Lavigne",
- "vendeur_prenom": "Jules",
- "acheteur_nom": "Dupont",
- "acheteur_prenom": "Louise",
- "adresse_titre": "11 Avenue Marcel Journet",
- "document_titre": "Residence 11 Avenue Marcel Journet 06370 Mouans-Sartoux",
- "ref_interne": "Lot N°2",
- "type": 1,
- "transaction_type": 1,
- "surveillance": 1,
- "conclusions_format": 1,
- "erp_type": 1
}
]
}
<?xml version="1.0" encoding="UTF-8"?> <data> <result>succès</result> <code>200</code> <datas> <item0> <result>succès</result> <cadastreIds>01443000AA0014,01443000AA0015,01443000AA0016</cadastreIds> <pdf_name>https://www.ernmt-officiel.com/front/images/uploads/files/ernmt/API/28494/ERP_975105_20220122.pdf?t=1642845619</pdf_name> <ref>2014847</ref> <conclusions>Plans de Prévention des Risques : - Naturels : aucun - Miniers : aucun - Technologiques : aucun Radon de niveau 1, Séisme de niveau 2 ENSA : aucune nuisance aérienne n'a été identifiée sur le bien. Pollution des sols sur un rayon de 500m (BASIAS, BASOL, ICPE) : 8 sites. </conclusions> </item0> <item1> <result>succès</result> <cadastreIds>01443000AA0017</cadastreIds> <pdf_name>https://www.ernmt-officiel.com/front/images/uploads/files/ernmt/API/28494/ERP_975106_20220122.pdf?t=1642845622</pdf_name> <ref>2014848</ref> <conclusions>Plans de Prévention des Risques : - Naturels : aucun - Miniers : aucun - Technologiques : aucun Radon de niveau 1, Séisme de niveau 2 ENSA : aucune nuisance aérienne n'a été identifiée sur le bien. Pollution des sols sur un rayon de 500m (BASIAS, BASOL, ICPE) : 8 sites. </conclusions> </item1> </datas> </data>
Utiliser une liste de coordonnées latitude / longitude pour créer les rapports ERP ou ENSA
format | string Default: "xml" Enum: "xml" "json" Format de réponse |
Liste des coordonnées latitude / longitude
Array of objects Liste des rapports commandés par coordonnées latitude / longitude |
{- "rapports": [
- {
- "lat": 45.7984979,
- "long": 5.0852539,
- "vendeur_nom": "Lavigne",
- "vendeur_prenom": "Jules",
- "acheteur_nom": "Dupont",
- "acheteur_prenom": "Louise",
- "adresse_titre": "11 Avenue Marcel Journet",
- "document_titre": "Residence 11 Avenue Marcel Journet 06370 Mouans-Sartoux",
- "ref_interne": "Lot N°2",
- "type": 1,
- "transaction_type": 1,
- "surveillance": 1,
- "conclusions_format": 1,
- "erp_type": 1
}
]
}
<?xml version="1.0" encoding="UTF-8"?> <data> <result>succès</result> <code>200</code> <datas> <item0> <result>succès</result> <lat>48.845497</lat> <long>2.436682</long> <pdf_name>https://www.ernmt-officiel.com/front/images/uploads/files/ernmt/API/28494/ERP_975091_20220119.pdf?t=1642621382</pdf_name> <ref>2014847</ref> <conclusions>Plans de Prévention des Risques : - Naturels : aucun - Miniers : aucun - Technologiques : aucun Radon de niveau 1, Séisme de niveau 1 ENSA : aucune nuisance aérienne n'a été identifiée sur le bien. Pollution des sols sur un rayon de 500m (BASIAS, BASOL, ICPE) : 69 sites. </conclusions> </item0> <item1> <result>succès</result> <lat>48.786472</lat> <long>2.4458</long> <pdf_name>https://www.ernmt-officiel.com/front/images/uploads/files/ernmt/API/28494/ERP_975092_20220119.pdf?t=1642621384</pdf_name> <ref>2014848</ref> <conclusions>Plans de Prévention des Risques : - Naturels : inondation, mouvements de terrain - Miniers : aucun - Technologiques : aucun Radon de niveau 1, Séisme de niveau 1 ENSA : aucune nuisance aérienne n'a été identifiée sur le bien. Pollution des sols sur un rayon de 500m (BASIAS, BASOL, ICPE) : 18 sites. </conclusions> </item1> </datas> </data>
Utiliser une liste de rapport identifiants pour renouveler les rapports ERP ou ENSA
format | string Default: "xml" Enum: "xml" "json" Format de réponse |
Liste d'identifiants des rapports
refs required | Array of integers Liste d'identifiants des rapports |
{- "refs": [
- 975086,
- 975081
]
}
<?xml version="1.0" encoding="UTF-8"?> <data> <result>succès</result> <code>200</code> <datas> <item0> <result>succès</result> <ref>975086</ref> <pdf_name>http://www.ernmt-officiel.com/front/images/uploads/files/ernmt/API/28494/ERP_975086_20211016.pdf?t=1650090973</pdf_name> </item0> <item1> <result>succès</result> <ref>975081</ref> <pdf_name>https://www.ernmt-officiel.com/front/images/uploads/files/ernmt/API/28494/ERP_975081_20211011.pdf?t=1650090975</pdf_name> </item1> </datas> </data>