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. Voici les données disponibles depuis cette API. (A noter qu'en remplacant nosdeputes.fr en nossenateurs.fr il est possible d'avoir les même données pour le Sénat). == 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 == 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 == Widget résumé d'un député == Retourne une zone html de largeur 935px proposant pour un député son titre, sa photo, son graphe, sa barre d'activité et ses mots-clés. L'accès est proposé via les URLs de la forme http://www.nosdeputes.fr/widget/#NOM avec #NOM idéalement de la forme "slug" (fourni dans les listes et informations individuelles de députés, cf ci-dessus), "Prénom Nom" ou encore (sous réserve d'homonymes) "Nom". Les options notitre, nophoto, nographe, noactivite et notags peuvent être utilisées de façon complémentaire pour n'afficher qu'une partie des éléments. Par exemple pour François Hollande sans la barre d'activité ni le titre : http://www.nosdeputes.fr/widget/hollande?noactivite=1¬itre=1 Il est relativement aisé d'inclure ces éléments sur un autre site à l'aide d'iframe en html, de file_get_contents en php, d'ajax en javascript, ... Par exemple la page http://www.regardscitoyens.org/gouvernement2012/ est écrite tout simplement ainsi : {{{ }}} == Chiffres de la synthèse == - 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 == Résultats du moteur de recherche == Tous les résultats du [http://www.nosdeputes.fr/recherche/ 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.