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",
- "type": 1,
- "transaction_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> </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> </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",
- "type": 1,
- "transaction_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,014450000A0352,014490000A0150</cadastreIds> <pdf_name>https://www.ernmt-officiel.com/front/images/uploads/files/ernmt/API/28494/ERP_975105_20220122.pdf?t=1642845619</pdf_name> </item0> <item1> <result>succès</result> <cadastreIds>01443000AA0014</cadastreIds> <pdf_name>https://www.ernmt-officiel.com/front/images/uploads/files/ernmt/API/28494/ERP_975106_20220122.pdf?t=1642845622</pdf_name> </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",
- "type": 1,
- "transaction_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> </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> </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>