| Version 12 (modified by , 12 years ago) ( diff ) |
|---|
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.
Sont disponibles (toujours remplacer deputes en senateurs pour le Sénat) :
- la liste de tous les députés depuis 2007 :
- 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
- la 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
- 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
- la photo d'un député (ici Guy Teissier avec 60 pixels de hauteur) :
- les chiffres correspondant à notre synthèse mois par mois (ici pour le mois d'avril 2010) :
- en xml http://www.nosdeputes.fr/synthese/201004/xml
- en format tableur (csv) http://www.nosdeputes.fr/synthese/201004/csv
- en json http://www.nosdeputes.fr/synthese/201004/json
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.
Les informations diffusées sur NosDeputes.fr sont disponibles sous CC-BY-SA et ODBL.
