Version 37 (modified by 8 years ago) ( diff ) | ,
---|
Obsolète. Migré et maintenu sur https://github.com/regardscitoyens/nosdeputes.fr/blob/master/doc/api.md
Une API a été développée pour offrir un accès aux données de NosDeputes.fr ou NosSenateurs.fr aux formats XML, JSON et CSV.
Note : les données sont proposées en utf-8. Si vous vous retrouvez face à des caractères kabbalistiques, cela signifie qu'il vous faut régler l'encodage dans les options du logiciel avec lequel vous manipulez les données. Si votre tableur ne vous permet de spécifier l'encodage, vous pouvez rajouter l'option ?withBOM=true à la fin de l'url du fichier CSV que vous cherchez à télécharger.
Voici les données disponibles depuis cette API. (A noter qu'en remplacant nosdeputes.fr en nossenateurs.fr et deputes par senateurs il est possible d'avoir les même données pour le Sénat, les urls ayant alors la forme http://www.nossenateurs.fr/senateurs/...). Concernant l'Assemblée, les données de la 13ème législature sont accessibles de manière permanente à l'adresse 2007-2012.nosdeputes.fr, tandis que celles de la 14eme se trouvent sur www.nosdeputes.fr et de façon permanente sur 2012.nosdeputes.fr.
L'ensemble des données de ces différents sites est par ailleurs disponible intégralement sous la forme de dumps sql disponibles ici : http://www.regardscitoyens.org/telechargement/donnees/
Si vous souhaitez embarquer une partie de la page consacrée à un parlementaire, un widget a été développé a cet effet. Son usage est décrit sur la page Widget
Liste de tous les députés d'une législature
- en XML : http://www.nosdeputes.fr/deputes/xml
- en JSON : http://www.nosdeputes.fr/deputes/json
- en format tableur (csv) : http://www.nosdeputes.fr/deputes/csv
Liste de tous les députés en cours de mandat
Avec informations complémentaires sur chacun (mandats, groupe, e-mails, adresses, sites webs, ...) :
- en XML : http://www.nosdeputes.fr/deputes/enmandat/xml
- en JSON : http://www.nosdeputes.fr/deputes/enmandat/json
- en format tableur (csv) : http://www.nosdeputes.fr/deputes/enmandat/csv
Information d'un député particulier
Toutes les infos que nous stockons sur un député (ici Guy Teissier) :
- en xml : http://www.nosdeputes.fr/guy-teissier/xml
- en json : http://www.nosdeputes.fr/guy-teissier/json
- en format tableur (csv) : http://www.nosdeputes.fr/guy-teissier/csv
Photo d'un député
Exemple pour Guy Teissier avec 60 pixels de hauteur : http://www.nosdeputes.fr/depute/photo/guy-teissier/60
Chiffres de la synthèse sur tous les députés
- les chiffres correspondant à notre synthèse mois par mois (ici pour le mois d'avril 2010) :
- en xml http://2007-2012.nosdeputes.fr/synthese/201004/xml
- en format tableur (csv) http://2007-2012.nosdeputes.fr/synthese/201004/csv
- en json http://2007-2012.nosdeputes.fr/synthese/201004/json
- les chiffres correspondant aux 12 derniers mois ou à toute la législature affichés sur la synthèse :
- en xml http://www.nosdeputes.fr/synthese/data/xml
- en format tableur (csv) http://www.nosdeputes.fr/synthese/data/csv
- en json http://www.nosdeputes.fr/synthese/data/json
Résultats du moteur de recherche
Tous les résultats du moteur de recherche sont également accessibles via l'API : il suffit de rajouter le paramètre format à l'url de recherche. Il pourra prendre comme valeur xml, json ou csv.
- résultats xml de la 2d page d'une recherche sur Internet : http://www.nosdeputes.fr/recherche/internet?page=2&format=xml
- résultats json de la recherche sur Citoyens : http://www.nosdeputes.fr/recherche/citoyens?format=json
- résultats tableur (csv) sur la recherche Députés : http://www.nosdeputes.fr/recherche/députés?format=csv
Différents paramètres peuvent être ajoutés aux requêtes de recherche pour préciser les résultats :
- pour limiter à un type d'objet précis (Parlementaire, Organisme, Intervention, Amendement, QuestionEcrite, Section, Texteloi, Commentaire) ajouter &object_name=OBJTYPE
- pour limiter les résultats à une période temporelle précise, ajouter &date=YYYYMMDD%2CYYYYMMDD
- pour limiter les résultats à un parlementaire précis, ajouter &tag=parlementaire=PARL_SLUG
- pour limiter les résultats à ceux associés à des mots-clés, ajouter &tag=KEYWORD1,KEYWORD2,...
- pour obtenir (avec le format json uniquement) les statistiques du résultat d'une recherche, vous pouvez utiliser au choix les options suivantes :
- &parlfacet=1 (répartition des résultats par députés)
- &tagsfacet=1 (répartition des résultats par mots-clés)
- &timefacet=1 (répartition des résultats par période temporelle : 1 mois si la période considérée dépasse 90 jours, 1 jour sinon)
Les résultats indiquent un total de résultats (lastResult) et sont délivrés par lots de 20, utiliser le paramètre &page=N pour accéder aux résultats N° 20*N+1 à 21*N. Le premier et le dernier indice des résultats fournis pour une page donnée sont indiqués par les champs start et end.
Conditions d'utilisation
Les informations diffusées sur NosDeputes.fr sont disponibles sous CC-BY-SA et ODBL. Cela signifie que vous êtes libre de les réutiliser, modifier et recouper dans la mesure où vous indiquez leur source (NosDéputés/Sénateurs.fr par Regards Citoyens à partir de l'Assemblée nationale/du Sénat et du Journal Officiel) et que vous republiez de votre côté les éventuelles données modifiées servant à une réutilisation publiée.