ERNMT OFFICIEL API DOCUMENTATION (3.0)

E-mail: service@ernmt-officiel.com URL: https://www.ernmt-officiel.com Terms of Service

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.

Introduction

Le web service retourne un fichier XML ou JSON avec au moins un code (erreur ou succès) et un message descriptif. Prérequis:

Disposer d’un compte actif sur ernmt-officiel.com
Disposer un solde positif de Crédits API pour commander un ERP ou ENSA
Disposer un Jeton d’accès

Crédits

Nombre de crédits API sur votre compte.

Actifs

Récupérer le nombre courant de crédits API actifs sur votre compte

Authorizations:

Basic Authentication

query Parameters

format

string

Default: "xml"

Enum: "xml" "json"

Format de réponse

Responses

Request samples

PHP-cURL
PHP-Guzzle
JavaScript
Python
cURL

<?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;

Response samples

200
401
500

Content type

application/xml

<?xml version="1.0" encoding="UTF-8"?>
<data>
  <result>succès</result>
  <creditsActifs>15</creditsActifs>
</data>

LatLong

Récupérer des informations de géolocalisation basées sur des adresses ou des cadastres.

Adresses

Utiliser une liste d'adresses pour récupérer leur coordonnées

Authorizations:

Basic Authentication

query Parameters

format

string

Default: "xml"

Enum: "xml" "json"

Format de réponse

Request Body schema: application/json

Liste des adresses

adresses

required

Array of strings

Liste des adresses

Responses

Request samples

Content type

application/json

{"adresses": ["3 place du grand pavois 94000 Créteil",
"1 Quai d’Anjou 75004 Paris"
]
}

Response samples

200
400
401
500

Content type

application/xml

<?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>

Cadastres

Utiliser une liste de cadastres pour récupérer leur coordonnées

Authorizations:

Basic Authentication

query Parameters

format

string

Default: "xml"

Enum: "xml" "json"

Format de réponse

Request Body schema: application/json

Liste des cadastres

required

Array of Code postal & Ville (object) or Insee (object) or CadastreId (object)

Liste des parcelles

Responses

Request samples

Content type

application/json

{"parcelles": [{"code_postal": "01330",
"ville": "VILLARS LES DOMBES",
"prefix": "000",
"section": "AA",
"numero": 14
},
{"insee": "01443",
"prefix": "000",
"section": "AA",
"numero": 15
},
{"cadastreId": "01443000AA0016"
}
]
}

Response samples

200
400
401
500

Content type

application/xml

<?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>

Rapport

Commander une rapport ERP ou ENSA.

Adresses

Utiliser une liste d'adresses pour créer les rapports ERP ou ENSA

Authorizations:

Basic Authentication

query Parameters

format

string

Default: "xml"

Enum: "xml" "json"

Format de réponse

Request Body schema: application/json

Liste des adresses

Array of objects

Liste des rapports commandés par adresse

Responses

Request samples

Content type

application/json

{"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
}
]
}

Response samples

200
400
401
500

Content type

application/xml

<?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>

Cadastres

Utiliser une liste de parcelles pour créer les rapports ERP ou ENSA

Authorizations:

Basic Authentication

query Parameters

format

string

Default: "xml"

Enum: "xml" "json"

Format de réponse

Request Body schema: application/json

Liste des parcelles

Array of objects

Liste des rapports commandés par parcelle

Responses

Request samples

Content type

application/json

{"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
}
]
}

Response samples

200
400
401
500

Content type

application/xml

<?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>

LatLongs

Utiliser une liste de coordonnées latitude / longitude pour créer les rapports ERP ou ENSA

Authorizations:

Basic Authentication

query Parameters

format

string

Default: "xml"

Enum: "xml" "json"

Format de réponse

Request Body schema: application/json

Liste des coordonnées latitude / longitude

Array of objects

Liste des rapports commandés par coordonnées latitude / longitude

Responses

Request samples

Content type

application/json

{"rapports": [{"lat": 45.7984979,
"long": 5.0852539,
"vendeur_nom": "Lavigne",
"vendeur_prenom": "Jules",
"acheteur_nom": "Dupont",
"acheteur_prenom": "Louise",
"type": 1,
"transaction_type": 1
}
]
}

Response samples

200
400
401
500

Content type

application/xml

<?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>

Renew

Utiliser une liste de rapport identifiants pour renouveler les rapports ERP ou ENSA

Authorizations:

Basic Authentication

query Parameters

format

string

Default: "xml"

Enum: "xml" "json"

Format de réponse

Request Body schema: application/json

Liste d'identifiants des rapports

refs

required

Array of integers

Liste d'identifiants des rapports

Responses

Request samples

Content type

application/json

{"refs": [975086,
975081
]
}

Response samples

200
400
401
500

Content type

application/xml

<?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>