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