Loading…
Loading…
Publique, gratuite et ouverte sans clé. Adresse de base : https://crossingthefloor.ca
Les points d’accès marqués « hérité » sont façonnés par le modèle d’origine à 25 tables, qui ne comporte ni niveau de vérification, ni graphe de références, ni moyen de représenter un caucus ayant changé d’allégeance en bloc. Ils demeurent accessibles afin de ne pas rompre les intégrations existantes. Le modèle canonique est celui que le site lit désormais et celui que portera l’exportation versionnée; si vous commencez un travail aujourd’hui, appuyez-vous sur ce dernier.
/api/v2modèle canoniqueCe qu’est cette API, ce qu’elle refuse de faire, et la liste de chaque point d’accès avec ses paramètres.
locale(string)en ou fr. Sélectionne la langue des textes localisés. Lorsqu’un champ n’a aucun texte dans cette langue, la réponse le signale plutôt que d’y substituer l’autre en silence.Envelope: name, openapi URL, endpoints[]./api/v2/eventsmodèle canoniqueListe paginée des événements d’affiliation. Les fiches retirées sont exclues sauf demande explicite, et un départ collectif constitue un seul événement portant son nombre de participants, jamais plusieurs traversées.
verification(string)unverified, corroborated ou official_and_independent. Ce filtre seul ne constitue pas un seuil de publication : une fiche retirée peut demeurer corroborée.publishedOnly(boolean)Limiter aux fiches franchissant l’ensemble du seuil de publication en trois volets. C’est le filtre à employer avant de citer quoi que ce soit comme établi.includeWithdrawn(boolean)Inclure les fiches rétractées. Elles sont conservées sous leur identifiant d’origine afin que quiconque en a cité une puisse constater ce qui s’est passé.jurisdiction(string)Identifiant, code ISO 3166-2 ou identifiant public. Répétez pour un OU. Une valeur ne correspondant à rien renvoie zéro ligne ET un avertissement de filtre non résolu, de sorte qu’une faute de frappe ne puisse passer pour une absence d’histoire.search(string)Recherche en texte libre sur les titres et les noms des personnes participantes.perPage(number)Taille de page. Pour l’intégralité du jeu de données en une requête, utilisez /api/v2/export, qui n’est ni paginé ni plafonné.Envelope: data[] of events, meta.pageInfo, meta.dataRelease, warnings[]./api/v2/events/{idOrSlug}modèle canoniqueUn événement avec l’ensemble de son graphe probatoire : participations, affirmations, sources citées pour chacune, révisions éditoriales et historique des versions.
locale(string)en ou fr. Sélectionne la langue des textes localisés. Lorsqu’un champ n’a aucun texte dans cette langue, la réponse le signale plutôt que d’y substituer l’autre en silence.Envelope: the event, its participants, claims, sources, reviews and revisions./api/v2/personsmodèle canoniqueListe paginée des personnes. Une même personne peut générer plusieurs événements : un dénombrement de personnes et un dénombrement d’événements mesurent donc des choses différentes.
withEventsOnly(boolean)Limiter aux personnes comptant au moins un événement d’affiliation consigné.search(string)Recherche en texte libre sur les noms consignés.Envelope: data[] of persons, meta.pageInfo./api/v2/persons/{idOrSlug}modèle canoniqueUne personne et l’intégralité de son parcours d’affiliation dans chacune des législatures concernées.
locale(string)en ou fr. Sélectionne la langue des textes localisés. Lorsqu’un champ n’a aucun texte dans cette langue, la réponse le signale plutôt que d’y substituer l’autre en silence.Envelope: the person and their participations./api/v2/partiesmodèle canoniqueListe paginée des partis politiques, avec les variantes de dénomination sous lesquelles un parti figure au registre.
withTransitionsOnly(boolean)Limiter aux partis figurant d’au moins un côté d’une transition consignée.jurisdiction(string)Limiter aux partis rattachés à une administration donnée.Envelope: data[] of parties, meta.pageInfo./api/v2/parties/{idOrSlug}modèle canoniqueUn parti avec ses variantes de dénomination, ses liens avec d’autres partis, et les mouvements entrants et sortants.
locale(string)en ou fr. Sélectionne la langue des textes localisés. Lorsqu’un champ n’a aucun texte dans cette langue, la réponse le signale plutôt que d’y substituer l’autre en silence.Envelope: the party, aliases, relationships and flows./api/v2/sourcesmodèle canoniqueListe paginée des sources probatoires, avec leur niveau de fiabilité et le résultat de la plus récente vérification de lien.
citedOnly(boolean)Limiter aux sources effectivement citées par une affirmation.linkStatus(string)Filtrer selon le résultat de la plus récente vérification de lien.reliabilityTier(string)Filtrer selon le niveau de fiabilité consigné.Envelope: data[] of sources, meta.pageInfo./api/v2/sources/{id}modèle canoniqueUne source, l’historique de ses vérifications de lien, et chaque affirmation qui la cite.
locale(string)en ou fr. Sélectionne la langue des textes localisés. Lorsqu’un champ n’a aucun texte dans cette langue, la réponse le signale plutôt que d’y substituer l’autre en silence.Envelope: the source, its checks and its citing claims./api/v2/coveragemodèle canoniqueCe que la base contient et ne contient pas, calculé à partir des enregistrements réels à chaque appel. Chaque répartition porte son dénominateur, et la frontière de fraîcheur indique la fiche la plus récente détenue pour chaque administration. Commencez ici avant de citer un total.
locale(string)en ou fr. Sélectionne la langue des textes localisés. Lorsqu’un champ n’a aucun texte dans cette langue, la réponse le signale plutôt que d’y substituer l’autre en silence.Envelope: coverage (the full report), headline, and reconciliation against external figures./api/v2/contextmodèle canoniqueQuelle est la rareté d’une transition comme celle-ci ? Renvoie des décomptes comparables avec leurs dénominateurs, la première et la plus récente occurrence, ainsi qu’une phrase citable dans les deux langues. Aucun taux n’est renvoyé, presque aucune participation ne portant de retombée consignée.
fromParty(string)Parti quitté. Les noms figurant dans la réponse proviennent de la fiche de parti résolue et non de votre graphie, de sorte qu’un filtre ayant visé autre chose reste apparent.toParty(string)Parti rejoint. Pour un passage aux banquettes indépendantes, employez plutôt toAffiliationLabel : ces participations n’ont aucun parti de destination.sinceYear(number)Borne inférieure inclusive de l’année pour l’ensemble comparable.excludeEvent(string)Identifiant public d’un événement à exclure — normalement celui dont vous traitez.Envelope: context (comparable set, ordinal, first, most recent, outcome tallies) and quotable.en / quotable.fr./api/v2/releasesmodèle canoniqueVersions publiées du jeu de données. Citez la version consultée en indiquant la date de consultation.
includeUnpublished(boolean)Inclure les versions préparées mais non publiées.Envelope: data[] of releases, meta.pageInfo./api/v2/releases/{version}modèle canoniqueUne version publiée avec son manifeste et les décomptes consignés au moment de sa création. Ces décomptes sont historiques et signalés comme tels; ce ne sont pas les totaux actuels.
locale(string)en ou fr. Sélectionne la langue des textes localisés. Lorsqu’un champ n’a aucun texte dans cette langue, la réponse le signale plutôt que d’y substituer l’autre en silence.Envelope: the release, its artifacts and its counts at release time./api/v2/correctionsmodèle canoniqueLe registre public des corrections : ce qui était erroné, ce par quoi cela a été remplacé, et à quelle date.
materialOnly(boolean)Limiter aux corrections qualifiées de substantielles pour la fiche.recordPublicId(string)Corrections touchant une fiche donnée, par son identifiant public.Envelope: data[] of corrections, meta.pageInfo./api/v2/exportmodèle canoniqueExportation en bloc de l’ensemble du jeu de données. Diffusée en continu, jamais paginée ni plafonnée : le nombre de lignes correspond au jeu filtré, et non à une page de celui-ci. Accepte les mêmes filtres que /api/v2/events.
format(string)csv, json ou jsonl. Le CSV est conforme à la RFC 4180 avec fins de ligne CRLF; il s’agit d’un véritable CSV, et non du corps JSON sous un autre type de contenu.dataset(string)La table à exporter : events, participants et les autres jeux de données publiés.bom(boolean)Ajouter une marque d’ordre des octets UTF-8, pour les tableurs qui l’exigent. CSV seulement.A manifest object carrying the licence, release and column order, then the rows./api/v2/openapi.jsonmodèle canoniqueLa spécification lisible par machine, produite à partir du même registre de routes que celui qui traite les requêtes : elle ne peut donc pas diverger de l’API qu’elle décrit. Chaque paramètre de chaque point d’accès y est documenté.
Aucun paramètre.
An OpenAPI 3.1 document./api/crossingsmodèle héritéListe paginée des traversées selon le modèle hérité.
q(string)Recherche en texte libre. Le paramètre est q; une documentation antérieure de ce site le nommait search, ce que le code n’a jamais lu.level(string)federal ou provincial. Champ hérité; il ne distingue pas les législatures territoriales.province(string)Nom de province en texte libre dans le modèle hérité, d’où l’apparition possible d’une même province sous deux graphies.category(string)Catégorie éditoriale héritée.yearFrom(number)Borne inférieure incluse pour l’année.yearTo(number)Borne supérieure incluse pour l’année.page(number)Numéro de page à partir de 1. Valeur par défaut : 1.perPage(number)Taille de page, plafonnée à 100. Valeur par défaut : 50.{ rows: Crossing[], total: number, page: number, perPage: number }/api/crossings/{slug}modèle héritéUne traversée et ses fiches héritées associées. Erreur 404 avec { error } si l’identifiant est inconnu.
Aucun paramètre.
CrossingWithRelations | { error: "Not found" }/api/persons/{slug}modèle héritéUne personne, ses traversées, et le nombre de nominations au Cabinet et au Sénat consignées.
Aucun paramètre.
{ person: { slug, nameEn, birthYear, deathYear }, crossings: […], cabinetCount: number, senateCount: number }/api/searchmodèle héritéRecherche en texte libre dans les fiches héritées. Renvoie un ensemble vide, et non une erreur, pour les requêtes de moins de deux caractères.
q(string)La requête. Minimum de deux caractères. Maximum de 20 résultats.{ results: Crossing[] }/api/statisticsmodèle héritéAgrégats calculés sur le modèle hérité. Ces totaux ne comportent pas de dénominateur et ne correspondent pas aux chiffres publiés par le rapport de couverture; en cas de divergence, c’est le rapport de couverture qui est calculé à partir du modèle canonique.
Aucun paramètre.
{ overview, categories, provinces, decades, flows, benefits }/api/erasmodèle héritéLes époques éditoriales servant à regrouper la chronologie.
Aucun paramètre.
Era[]/api/glossarymodèle héritéTermes du glossaire dans les deux langues.
Aucun paramètre.
GlossaryTerm[]/feed.xmlmodèle canoniqueFil RSS 2.0 des événements nouvellement publiés, tiré du modèle canonique et limité aux fiches franchissant l’ensemble du seuil de publication. Chaque élément indique son niveau de vérification et sa précision de date.
jurisdiction(string)Restreindre le fil à une seule administration, par identifiant ou code ISO (par exemple CA-NS). Une valeur inconnue produit un fil vide et le signale dans la description du canal, plutôt que de renvoyer discrètement l’ensemble.lang(string)en ou fr. Choisit la langue des titres et des résumés. Lorsqu’un texte français est absent, l’anglais est diffusé et l’élément est signalé comme non traduit.application/rss+xml/sitemap.xmlsiteChaque fiche d’événement, de personne et de parti publiée, ainsi que les pages éditoriales, avec une date de dernière modification tirée de la fiche elle-même. Les fiches retirées sont exclues.
Aucun paramètre.
application/xmlCes adresses renvoient actuellement une erreur 404. Rien sur cette page n’y renvoie comme téléchargement et elles sont exclues de la description lisible par machine du jeu de données; un robot de recherche de données ne vous les proposera donc pas non plus.
/api/v2/export?format=jsonPas encore accessibleÉvénements, participations, personnes, partis, administrations, affirmations, références et sources selon le modèle canonique, chaque champ de vérification et de précision étant conservé plutôt qu’aplati.
/api/v2/export?format=csvPas encore accessibleLes mêmes fiches sous forme de table à plat par entité, pour un tableur ou une session R ou Python. Les valeurs inconnues sont des cellules vides, documentées comme inconnues dans le dictionnaire de données; elles ne sont jamais écrites comme des zéros.
L’accès anonyme est soumis à une limite de débit par client et par heure, et aucune clé d’API n’est exigée ni délivrée : tout appelant est anonyme à l’heure actuelle. La limite en vigueur, la fenêtre, la part que vous en avez consommée et le moment de sa réinitialisation sont renvoyés à chaque réponse, dans les en-têtes RateLimit-* et dans meta.rateLimit; lisez-les à cet endroit plutôt que sur cette page, et prenez au mot une réponse qui déclare enforcement à not_enforced. Faites tout de même preuve de retenue — il s’agit d’un petit projet sur un hébergement modeste — et identifiez-vous au moyen d’un en-tête User-Agent comportant une adresse de contact, afin que nous puissions vous joindre plutôt que vous bloquer.
Base de données : CC BY 4.0 Creative Commons Attribution 4.0 International
Code, conception et identité visuelle du site : tous droits réservés
Crossing the Floor (crossingthefloor.ca), CC BY 4.0
Dictionnaire de données, versions publiées et téléchargements