• 12 Déc 2011
  • 18h02

API | Fédérations PS

API PS

Cette API vous permet d’accéder aux coordonnées des fédérations départementales du PS régulièrement mises à jour.

Accédez à la documentation technique.

Accès de la ressource

http://api.parti-socialiste.fr/v2/federations.[FORMAT]?[LOCALISATION]

Informations sur la ressource

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://api.parti-socialiste.fr/v2/federations.json

LOCALISATION

Rattachement à un espace géographique

  • Label : geo
  • Valeurs : (ufloat),(ufloat),[(int)],(int)
    Latitude, longitude, [altitude], distance

Requis
Exemples :

http://api.parti-socialiste.fr/v2/federations.json?geo=48.858888,2.32354,,500
http://api.parti-socialiste.fr/v2/federations.json?geo=48.84958,2.38024,41,5000

Gestion des erreurs

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

Erreur format

Wrong Format

Erreur Localisation

Wrong Localisation

Spécifications sortie JSON

Output en JSON sur le schéma suivant

{
"success":true,
"errors":[],
"data" : [{
	"field"  : "valeur",
	"field2" : "valeur"
}]
}

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

Liste des champs

  • id Identifiant unique de la fédération
  • name Nom de la fédération
  • address1 Adresse 1 de la fédération
  • address2 Adresse 2 de la fédération
  • postal_code Code postal de la fédération
  • insee_code Code INSEE (relatif au CP) de la fédération (cf. http://www.insee.fr/fr/methodes/nomenclatures/cog)
  • city Ville de la fédération
  • phone Numéro de téléphone de la fédération (optionnel)
  • email Adresse email publique
  • site_web URL du site internet (optionnel)
  • feed URL du flux RSS (optionnel)
  • calendar URL d’un flux ICS d’agenda (optionnel)
  • facebook URL du groupe / de la page facebook (optionnel)
  • twitter URL du compte twitter (optionnel)
  • flickr URL du compte flickr (optionnel)
  • dailymotion URL du compte dailymotion (optionnel)
  • lat Lattitude relatif à l’adresse de la fédé
  • long Longitude relatif à l’adresse de la fédé
  • altitude Altitude de la fédé
  • distance Distance de la fédé
  • google_address Formatage de l’adresse pour Google MAPS
  • google_status Retour erreur de l’API de Google MAPS
  • update_date Date de MAJ de la fédé

Exemple

{
"success":true,
"errors":[],
"data": [{
	"id":44,
	"name":"Fédération Loire-Altantique",
	"address1":"1, allée des Taneurs",
	"address2":"",
	"postal_code":"44000",
	"insee_code":"44109",
	"city":"NANTES",
	"phone":"+330240206300",
	"email":"fede44@parti-socialiste.fr",
	"site_web":"http://www.ps44.fr",
	"feed":"",
	"calendar":"",
	"facebook":"",
	"twitter":"",
	"flickr":"",
	"dailymotion":"",
	"lat":"47.217929",
	"long":"-1.557698",
	"altitude":"",
	"distance":"",
	"google_address":"1 Allée des Tanneurs, 44000 Nantes, France",
	"google_status":null,
	"update_date":1303325829
	}]
}