CLAIR API

Sujets

Server

Sujets : dossiers de l'AN et du Sénat portant sur le même texte


Liste des sujets

GET
https://api.clair.vote
/api/v1/sujets/

Retourne la liste paginée des sujets avec leurs statistiques

Liste des sujets › query Parameters

page
​integer · min: 1
Default: 1
limit
​integer · min: 1 · max: 100
Default: 20
category
​string

Filtrer par catégorie

search
​string

Recherche dans le label

featured
​boolean

Filtrer les sujets mis en avant

Liste des sujets › Responses

200

Default Response

No data returned

Sujets mis en avant

GET
https://api.clair.vote
/api/v1/sujets/featured

Retourne les sujets featured pour la homepage

Sujets mis en avant › query Parameters

limit
​integer · min: 1 · max: 20
Default: 6

Sujets mis en avant › Responses

200

Default Response

No data returned

Liste des catégories

GET
https://api.clair.vote
/api/v1/sujets/categories

Retourne toutes les catégories de sujets avec leur count

Liste des catégories › Responses

200

Default Response

No data returned

Détail d'un sujet

GET
https://api.clair.vote
/api/v1/sujets/{slug}

Retourne les informations détaillées d'un sujet

Détail d'un sujet › path Parameters

slug
​string · required

Détail d'un sujet › Responses

200

Default Response

No data returned

Destination d'un sujet désactivé

GET
https://api.clair.vote
/api/v1/sujets/{slug}/archive

Pour un sujet désactivé, renvoie l'UID du dossier qui en est la meilleure cible de redirection permanente, ou null s'il n'en portait aucun. 404 si le slug est inconnu ou toujours actif.

Destination d'un sujet désactivé › path Parameters

slug
​string · required

Destination d'un sujet désactivé › Responses

200

Default Response

No data returned

Documents liés à un sujet

GET
https://api.clair.vote
/api/v1/sujets/{slug}/documents-lies

Rapports d'information, missions d'application et textes non votés citant la loi du sujet. Absents de la liste des dossiers, qui exige au moins un scrutin.

Documents liés à un sujet › path Parameters

slug
​string · required

Documents liés à un sujet › Responses

200

Default Response

No data returned

Dossiers d'un sujet

GET
https://api.clair.vote
/api/v1/sujets/{slug}/dossiers

Retourne les dossiers législatifs associés à un sujet

Dossiers d'un sujet › path Parameters

slug
​string · required

Dossiers d'un sujet › query Parameters

page
​integer · min: 1
Default: 1
limit
​integer · min: 1 · max: 100
Default: 20

Dossiers d'un sujet › Responses

200

Default Response

No data returned

Parcours parlementaire d'un sujet

GET
https://api.clair.vote
/api/v1/sujets/{slug}/chronologie

Les réunions de commission et les séances publiques où les textes de ce sujet ont été examinés, dans l’ordre, chaque étape nommant le texte concerné.

Parcours parlementaire d'un sujet › path Parameters

slug
​string · required

Parcours parlementaire d'un sujet › Responses

200

Default Response

No data returned

Scrutins d'un sujet

GET
https://api.clair.vote
/api/v1/sujets/{slug}/scrutins

Retourne les scrutins associés à un sujet avec pagination

Scrutins d'un sujet › path Parameters

slug
​string · required

Scrutins d'un sujet › query Parameters

page
​integer · min: 1
Default: 1
limit
​integer · min: 1 · max: 100
Default: 20
chambre
​string · enum
Enum values:
assemblee
senat
nature
​string · enum

Objet du vote (sur quoi on vote)

Enum values:
ensemble
article
amendement
credits
motion
declaration
autre

Scrutins d'un sujet › Responses

200

Default Response

No data returned

Presse d'un sujet

GET
https://api.clair.vote
/api/v1/sujets/{slug}/presse

Articles de presse récupérés en live via Google Actualités (cache ~3h). Liens-only.

Presse d'un sujet › path Parameters

slug
​string · required

Presse d'un sujet › Responses

200

Default Response

No data returned

Stats d'un sujet

GET
https://api.clair.vote
/api/v1/sujets/{slug}/stats

Retourne les statistiques de votes par groupe pour un sujet

Stats d'un sujet › path Parameters

slug
​string · required

Stats d'un sujet › Responses

200

Default Response

No data returned