Codes postaux et villes !

Récupérez les codes postaux à partir des noms des communes Françaises

Récupérez les communes à partir des codes postaux Français

Une API pour les développeurs

Plus de 37000 références accessibles pour vos formulaires à récupérer au format JSON

 

Testez le service !

Par exemple tapez 695 puis 6950 puis 69500
ou tapez pap puis pape

** Pas trouvé **

Exemples d'utilisation

Récupération du code postal de Annecy via l'url http://www.cp-ville.com/cpcom.php?cpcommune=Annecy

Récupération du code postal de Annecy en Ajax avec jQuery :
$.getJSON("http://www.cp-ville.com/cpcom.php?jsoncallback=?", { cpcommune:'Annecy' });

idem que l'exemple précédent, le code détecte qu'on cherche une ville et pas un code postal
http://www.cp-ville.com/cpcom.php?cpcommune=69500

Récupération des villes en Ajax avec jQuery : $.getJSON("http://www.cp-ville.com/cpcom.php?jsoncallback=?", { cpcommune:'69500' });

NB : Dans les exemples ci-dessus avec jQuery et Ajax on suppose l'existence d'une fonction
javascript jsoncallback(data) qui exploite le retour des données au format Json.



Documentation de l'API

Argument

L'API qui permet de retrouver un code postal à partir d'une commune et inversement a été conçue dans un souci de grande simplcité d'utilisation.

Le nom du script de service : cpcom.php et un seul argument : cpcommune

La valeur de cet argument est soit un (début de) code postal soit un (début de) nom de ville

Le retour est renvoyé codé au format JSON.

Le plus simple est de tester l'url du service en direct.
Par exemple http://www.cp-ville.com/cpcom.php?cpcommune=pomp pour observer le retour des données au format JSON dans le navigateur.

Sont également retournés le nombre de résultats trouvés et le type ( si il s'agit de cp ou de commune(s) ) via les clefs "count" et "typeretour". Libre à vous d'utiliser ou non ces informations de retour.

En cas d'erreur, le retour comportera une clef 'erreur', avec un libellé explicatif, par exemple : {"erreur":"argument absent"}
Attention : le service étant susceptible d'évoluer un jour, si vous souhaitez être prévenu des modifications de l'API il est important de laisser votre mail via le formulaire de contact.

Gratuit

 

Dans le cadre d'une utilisation raisonnable.

Un lien sur votre site sera grandement apprécié lien apprécié

Me contacter en cas d'utilisation commerciale massive.

Des solutions pourront être trouvées au cas par cas

Attention : le service étant susceptible d'évoluer un jour, si vous souhaitez être prévenu des modifications de l'API il est important de laisser votre mail via le formulaire de contact.

Contact

Merci !

Je répondrai à votre message rapidement.