- 12 Déc 2011
- 18h02
API | Fédérations 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 }] }