• 12 Déc 2011
  • 17h05

API | Résultats des primaires citoyennes

Cette API vous permet d’accéder aux résultats des primaires citoyennes validés au niveau national et départemental.

Accédez à la documentation technique.

Accès de la ressource

Premier tour

Niveau National

http://resultats2.lesprimairescitoyennes.fr/[FORMAT]/nationaux

Niveau Départemental

http://resultats2.lesprimairescitoyennes.fr/[FORMAT]/[CODE_DEPARTEMENT]

Second tour

Niveau National

http://resultats2.lesprimairescitoyennes.fr/[FORMAT]/2/nationaux

Niveau Départemental

http://resultats2.lesprimairescitoyennes.fr/[FORMAT]/2/[CODE_DEPARTEMENT]

Format de réponse

JSON

Méthode HTTP

GET

Authentification requise

Non

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://resultats2.lesprimairescitoyennes.fr/json

CODE_DEPARTEMENT

Clé unique d’identification du département – Numéro du département sur trois caractères

Valeurs : (string){3}

  • Identifiant du département. (Pour la Corse : 02A et 02B)

Requis

Exemples :

http://resultats2.lesprimairescitoyennes.fr/json/departement/044
http://resultats2.lesprimairescitoyennes.fr/json/2/departement/044

Gestion des erreurs

Une requête mal formée doit renvoyer une structure de réponse vide du type :

Erreur IDENTIFIANT DEPARTEMENT

Retourne :

{
"error":
	{
	"type":"404",
	"message":"URL API invalide"
	}
}

Spécifications sortie JSON

Output en JSON sur le schéma suivant

{
"departement_code":"valeur",
"departement_name":"valeur",
"heure_maj" :"valeur",
"bureaux_vote":"valeur",
"votants":valeur,
"blancs_nuls":valeur,
    "nom_candidat" : {
	"voix"  : valeur,
	"pourcentage" : valeur,
	"nom_prenom" : "valeur valeur"
      }
}

Content-type header en output > Default: application/json

Liste des champs

  • departement_code (varchar) Numéro du département
  • departement_name (varchar) Nom du département (safe-name)
  • heure_maj (varchar) Heure et date de la MAJ du JSON des résultats validés au
  • format ISO 8601
  • bureaux_vote (varchar) Nombre de bureaux de vote validés sur le total des bureaux de vote des primaires citoyennes au niveau national
  • votants (int) Nombre de votants
  • blancs_nuls (int) Nombres de bulletins blancs ou nuls
  • nom_candidat (varchar) Normalisation nom+prenom du candidat en minuscule
  • voix (int) Nombre de votants pour le candidat
  • pourcentage (int entre 0 et 100) Pourcentage de votants pour le candidat
  • nom_prenom (varchar) Nom Prénom du candidat

Exemple

{
"departement_code":"44",
"departement_name":"LOIRE-ATLANTIQUE",
"heure_maj" :"2011-10-07T14:14:02+02:00",
"bureaux_vote":"40/120",
"votants":8000,
"blancs_nuls":14,
    "nom_candidat" : {
	"voix"  : valeur,
	"pourcentage" : valeur,
	"nom_prenom" : "valeur valeur"
      }
}