Comment intégrer notre solution LIVE ENSOADDRESS

Historique

Date Numéro de version Description
28/02/2022 1.0 Version 1 – lancement de l’API EnsoB2B
La fiabilisation d’une adresse postale nécessite plusieurs niveaux de qualification et de traitement afin de garantir une qualité de donnée intégrée et exploitable immédiatement pour vos usages internes. Afin de vous garantir ce niveau de fiabilité, notre solution intègre l’ensemble des points suivants :

Authentification

Afin d’accéder à nos services, il est indispensable de s’authentifier via une clé unique sécurisé (ou token) qui vous est fourni par Data Enso. Votre token doit être intégré dans le header sous le paramètre « api_key » et présent lors de chaque appel à l’API EnsoPhone.

Appels sur les serveurs

Les appels au service EnsoAdresse doivent être réalisés sur l’URL suivante :

				
					https://api.dataenso.com/address
				
			

Appel API ENSOADDRESS

Afin de récupérer les informations société en temps réel et obtenir des résultats fiables, voici la liste des champs disponibles pour composer votre recherche.

Champ

Statut

Type

Example

Commentaires

Api_key

Required

String

your-api-key

Token généré par Data Enso

addr

Required

String

2 rue huche

Adresse recherchée

country    

 

Optional

String

FRA

country code au format ISO 3166-1 alpha-3

Réponse de l’appel API

Après avoir réalisé l’appel à nos services, voici les champs disponibles en retour

Champ

Type

Exemple

Title

string

92 Avenue de France, 75013 Paris, France

Adress

 

 

Label

string

92 Avenue de France, 75013 Paris, France

countrycode

string

FRA

countryname

string

France

statecode

string

IDF

state

string

Île-de-France

county

string

Paris

city

string

Paris

district

string

13e Arrondissement

street

string

Avenue de France

postalcode

string

75013

housenumber

integer

92

Position

 

 

lat

integer

48.82943

lng

integer

2.37813

Access

 

 

lat

integer

48.82943

lng

integer

2.37813

mapView

 

 

west

integer

2.37676

south

integer

48.82853

east

integer

2.3795

north

integer

48.83033

Exemple de requête méthode Curl

				
					https://api.dataenso.com/address/?addr=2+rue+huche\
  -H "api_key: <YOUR-TOKEN>"
				
			

Réponse :

				
					{"items":
[
{"title":"2 Rue Huché, 92150 Suresnes, France",
"address":{"label":"2 Rue Huché, 92150 Suresnes, France","countryCode":"FRA","countryName":"France","stateCode":"IDF","state":"Île-de-France","county":"Hauts-de-Seine","city":"Suresnes","street":"Rue Huché","postalCode":"92150","houseNumber":"2"},
"position":{"lat":48.87574,"lng":2.22063},
"access":[{"lat":48.87576,"lng":2.22059}],
"mapView":{"west":2.21926,"south":48.87484,"east":2.222,"north":48.87664},

{"title":"2 Rue de la Huche, 06520 Grasse, France",
"address":{"label":"2 Rue de la Huche, 06520 Grasse, France","countryCode":"FRA","countryName":"France","stateCode":"PAC","state":"Provence-Alpes-Côte d'Azur","county":"Alpes-Maritimes","city":"Grasse","district":"Magagnosc","street":"Rue de la Huche","postalCode":"06520","houseNumber":"2"},
"position":{"lat":43.68065,"lng":6.96125},
"access":[{"lat":43.68064,"lng":6.96126}],
"mapView":{"west":6.96001,"south":43.67975,"east":6.96249,"north":43.68155},
]}

				
			

Pour recevoir par mail nos différentes Doc API merci de remplir le formulaire ci-dessous