Attention : ces API sont encore incomplêtes et leur format n'est pas définitif.
API REST

L'API REST donne accès en lecture seule aux données au format JSON.

Les points d'entrée vers les listes d'objets sont décrits ci-dessous. Les objets JSON renvoyés par l'API comprennent des hyperliens vers d'autres sections de l'API. En particulier, les items de liste comportent toujours un lien vers une version plus détaillée et les versions détaillées comportent la plupart du temps des liens vers les entités liées.

Recherche full-text

Il est possible de filtrer les résultats par une recherche textuelle, par exemple /rest/organes/?search=commission des lois. La recherche textuelle porte sur tous les champs textuels présents dans les entités.

Par défaut les résultats incluent les éléments comportant tous les termes recherchés mais il est possible d'écrire les requêtes différemment :

Pagination

Les listes d'objets sont paginées à raison de 10 objets par page, par défaut. Chaque page indique le nombre total d'objets de la collection et des liens vers les pages précédentes et suivantes, le cas échéant.

La taille des pages peut être modifiée (ex: /rest/acteurs/?page_size=20).

Relations et personnalisation des détails

Dans la version détaillée d'une entité, des liens permettent d'accéder à une version de l'entité dans laquelle les entités liées sont incluses.

Par exemple, le « projet de loi pour une République Numérique » (/rest/dossiers/DLR5L14N34516) comporte un lien vers les acteurs à l'origine de ce projet de loi (/rest/dossiers/DLR5L14N34516/acteurs).

La dernière partie de cette URL constitue en réalité une indication des informations souhaitées sur le dossier DLR5L14N34516, en l'occurrence le champ acteurs. Il est possible de la personnaliser en indiquant plusieurs champs séparés par des virgules ; par exemple /rest/dossiers/DLR5L14N34516/acteurs,titre,senat_chemin inclut aussi le titre du dossier et un lien vers le site du Sénat.

Lorsqu'un champ de relation est utilisé, il est aussi possible de préciser des chemins à inclure, en séparant les parties de chaque chemin avec des points. Par exemple, /rest/dossiers/DLR5L14N34516/acteurs.acteur.nom,acteurs.acteur.prenom,titre,senat_chemin aura le même résultat que le lien précédent, mais inclura en plus le nom et le prénom de chaque acteur.

Description Taille Point d'entrée API
Actes législatifs 32090 /rest/actes
Acteurs (ministres, parlementaires...) 2134 /rest/acteurs
Amendements 142694 /rest/amendements
Documents législatifs 8343 /rest/documents
Dossiers législatifs 3250 /rest/dossiers
Travaux d'import de données 6 /rest/jobs
Législatures 4 /rest/legislatures
Acteurs (ministres, parlementaires...) 55662 /rest/mandats
Organes (ministères, commissions, organismes...) 1685 /rest/organes
Régimes politiques 3 /rest/regimes
Réunions 37592 /rest/reunions
Scrutins 1354 /rest/scrutins
Thèmes 57 /rest/themes
API GraphQL

Cette API donne accès au schéma de données via des requêtes GraphQL.

Lorsqu'il est utilisé depuis un navigateur web, le point d'entrée ci-dessous présente une interface de requétage avec auto-complétion et une documentation auto-générée du modèle.

Cliquez ici pour ouvrir l'interface avec un exemple de requête permettant de lister les 10 premiers acteurs et leur 1er mandat, avec seulement certains champs renvoyés.

Description Point d'entrée API
Point d'entrée GraphQL /graphql/
Sources de données

Le tableau ci-dessous montre les travaux d'import des données et le résultat de leur dernière exécution.

Source Dernière exécution (durée) Objets État Fichier source
AN: scrutins il y a 5 heures (3 secondes) 1 OK Scrutins_XIV.json.zip (modifié il y a 2 jours)
AN: réunions il y a 4 heures (2 secondes) 1 OK Agenda_XIV.json.zip (modifié il y a 2 jours)
AN: amendements il y a 3 jours (22 minutes) 143392 OK Amendements_XIV.json.zip (modifié il y a 4 jours)
AN: dossiers législatifs il y a un jour (19 minutes) 45252 OK Dossiers_Legislatifs_XIV.json.zip (modifié il y a 2 jours)
AN: députés-sénateurs-ministres il y a 5 heures (6 minutes) 33327 OK AMO20_dep_sen_min_tous_mandats_et_organes_XIV.json.zip (modifié il y a un jour)
AN: députés (historique) il y a 5 heures (11 minutes) 51231 OK AMO30_tous_acteurs_tous_mandats_tous_organes_historique.json.zip (modifié il y a 2 jours)