wiki:API

Version 12 (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.

Sont disponibles (toujours remplacer deputes en senateurs pour le Sénat) :

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.

Les informations diffusées sur NosDeputes.fr sont disponibles sous CC-BY-SA et ODBL.