- 19 Déc 2011
- 11h06
API | Bureau de vote républicain
Cette API vous permet d’accéder à la liste de tous les bureaux de vote républicain d’une ville sur la base du code INSEE de la ville
Accédez à la documentation technique.
Accès de la ressource
http://bureauxdevote.lesprimairescitoyennes.fr/[FORMAT]/commune/[CODE_INSEE]/[API_KEY]
Informations sur la ressource
Format de réponse
JSON
Méthode HTTP
GET
Authentification requise
Oui
Paramètres
FORMAT
Définition du format de sortie
Valeurs : (string){3,6}
- json : Le format de sortie par défaut est JSON
Requis
Exemple :
http://bureauxdevote.lesprimairescitoyennes.fr/json
CODE_INSEEE
Numéro d’identification unique du bureau de vote primaire
Valeurs : (varchar){5}
- Identifiant du bureau de vote
Requis
Exemple :
http://bureauxdevote.lesprimairescitoyennes.fr/json/commune/75109
API KEY
Sans authentification, il est impossible de sortir les flux. Il convient donc de spécifier une clé secrète permettant de donner la visibilité de l’export correspondant.
Nous contacter pour obtenir la clé.
Valeurs : (string){32}
Requis
Exemple :
http://bureauxdevote.lesprimairescitoyennes.fr/json/bvp/324754/[API_KEY]
Gestion des erreurs
Une requête mal formée doit renvoyer une structure de réponse vide du type :
Erreur API Key
Si la clé secrète est invalide ou mal formée, retourne selon le cas une :
404 – NOT FOUND
403 – ACCESS FORBIDDEN
Erreur CODE INSEE MAL FORME
Retourne :
{ "error": { "type":"lenght", "message":"Le code INSEE doit contenir 5 caract\u00e8res" } }
Erreur CODE INSEE INVALIDE
Retourne :
{ "error": { "type":"invalid", "message":"Code INSEE invalide" } }
Erreur Localisation
Wrong Localisation
Spécifications sortie JSON
Output en JSON sur le schéma suivant
[ { "id":"", "nom":"", "adresse":"", "bvp_id":"" } ]
Content-type header en output > Default: application/json
Liste des champs
- id Identifiant unique du bureau de vote républicain
- nom Nom du bureau de vote républicain
- adresse Adresse du bureau de vote républicain
- bvp_id Identifiant unique du BVP rattaché au BVR
Exemple
[ { "id":"83515", "nom":"Mairie D'arrondissement", "adresse":"6, Rue Drouot ", "bvp_id":"324754" }, { "id":"83517", "nom":"Mairie D'arrondissement", "adresse":"6, Rue Drouot ", "bvp_id":"324754" }, { "id":"83519", "nom":"Ecole Maternelle", "adresse":"11, Rue De La Grange Bateli\u00e8re ", "bvp_id":"324755" } ]