wiki:API

Version 31 (modified by roux, 8 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.

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 il est possible d'avoir les même données pour le Sénat). 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.

Liste de tous les députés d'une législature

Liste de tous les députés en cours de mandat

Avec informations complémentaires sur chacun (mandats, groupe, e-mails, adresses, sites webs, ...) :

Information d'un député particulier

Toutes les infos que nous stockons sur un député (ici Guy Teissier) :

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é

Note : Pour la 14ème législature à partir de juillet 2012, les adresses ci-dessous doivent être remplacées par widget14 en lieu et place de widget. Les widget de la 13ème législature restent accessibles de manière permanente sur 2007-2012.nosdeputes.fr/widget

Pour exporter des morceaux de NosDeputes.fr sur un autre site : retourne une zone html 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", par exemple : http://www.nosdeputes.fr/widget/ayrault

Plusieurs options peuvent également être passées en paramètres :

  • 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 (activer avec valeur 1 ou true).
  • L'option maxtags peut être précisée pour limiter le nombre de mots-clés affichés. Par défaut la valeur maximale affichée est de 40 mots-clés.
  • L'option width permet de définir la largeur totale de la zone produite. Par défaut la taille normale est de 935 pixels.
  • L'option iframe est à employer lors de l'usage d'un iframe html pour intégrer le widget, afin d'assurer le bon fonctionnement des liens (activer avec valeur 1 ou true).

Quelques exemples :

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 :

<?php
  $anciens_deputes = array("HOLLANDE", "Ayrault", "FABIUS", "TAUBIRA", "MOSCOVICI", "TOURAINE", "VALLS", "MONTEBOURG", "SAPIN", "FILIPPETTI", "FIORASO", "LEBRANCHU", "LUREL", "FOURNEYRON", "CAHUZAC", "PAU-LANGEVIN", "VIDALIES", "BATHO", "LAMY", "CAZENEUVE", "DELAUNAY", "PINEL", "CUVILLIER");
  foreach ($anciens_deputes as $d)
    echo file_get_contents('http://www.nosdeputes.fr/widget/'.$d.'?maxtags=15');
?>

Pour un usage simplifié, nous proposons une interface web permettant de réaliser des essais et de disposer d'une simple ligne html à insérer : http://www.nosdeputes.fr/widget14

Chiffres de la synthèse sur tous les députés

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.

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.