Les données
Provenance
Chaque mesure provient d’une publication d’une autorité publique. Chaque enregistrement nomme sa source, indique ce que la licence de cette source lui permet de contenir et fournit la mention de source à afficher.
Les champs de provenance
Chaque enregistrement complet comporte un objet provenance ; la vue compacte place source_id, rights_mode et last_checked_at au premier niveau. Les champs que vous lirez le plus souvent :
| Champ | Signification |
|---|---|
| provenance.source_id | La source d’où l’enregistrement a été lu (curated_federal, eu_funding_tenders, ...). C’est l’id qu’acceptent le filtre source et le filtre sources des webhooks. Dans la vue compacte : source_id. |
| provenance.source_url | La page d’où l’enregistrement a été lu, également servie comme links.official. |
| provenance.rights_mode | Ce que la licence de la source permet à l’enregistrement de contenir : open_licence, facts_only ou link_only (voir ci-dessous). Dans la vue compacte : rights_mode. |
| provenance.source_license | Le nom de la licence applicable. |
| provenance.attribution | La mention de source demandée par la licence, ou null si elle n’en demande pas. Voir mention de la source. |
| provenance.last_checked_at | La dernière lecture de la source où elle disait toujours ceci. Dans la vue compacte : last_checked_at. |
| provenance.source_last_modified_at | La date de dernière modification de la page, selon la source elle-même. |
| provenance.sources[] | Chaque source qui décrit la mesure, la principale d’abord. |
Tous les champs de provenance sont décrits dans le modèle de données.
Modes de droits
Chaque source a un mode de droits, qui découle de sa licence. Chaque enregistrement le porte dans provenance.rights_mode, la vue compacte dans rights_mode. Il détermine ce que contient l’enregistrement :
| Mode | Ce que contient l’enregistrement |
|---|---|
| open_licence | La licence de la source autorise la réutilisation de son texte avec mention de la source (par exemple CC BY 4.0, CC0 ou la licence flamande de réutilisation). Le résumé peut être celui de la source (summary_origin: "source") et status_note peut reprendre ses termes. |
| facts_only | L’enregistrement contient les faits : dates, montants, taux, qui peut introduire une demande, les règles, un résumé généré à partir de ces faits (summary_origin: "generated") et le lien vers la page officielle. Le texte propre de la source n’y figure pas. |
| link_only | Titre et lien uniquement. |
Résumés
summary_origin indique d’où vient le résumé servi dans votre langue : source est le texte de la source elle-même, generated est généré à partir des faits de l’enregistrement (type d’aide et organisme, pour qui et où, combien, et quand). summary_basis dit la même chose pour l’enregistrement dans son ensemble : un enregistrement dont la source a rédigé le résumé en néerlandais peut servir un résumé généré en français ou en anglais. Les titres ne sont ni générés ni traduits : un titre existe dans les langues où la source l’a publié, et titles vaut null pour les autres.
Mention de la source
Quand une licence demande une mention de la source, l’enregistrement la porte dans provenance.attribution, et la licence dans provenance.source_license. Une réponse de liste rassemble les mentions de ses lignes dans meta.attribution. Si vous affichez le texte d’un enregistrement en open_licence, affichez sa mention avec lui ; pour le contenu d’EU Funding & Tenders, il s’agit de la Commission européenne sous CC BY 4.0. Chaque enregistrement renvoie aussi vers la page de l’autorité dans links.official : affichez-la, car c’est cette page qui fait foi, et non cette API. Redistribuer les données elles-mêmes à des tiers nécessite une formule qui le prévoit ; voir les conditions.
Fraîcheur
Chaque enregistrement porte la fraîcheur de sa source dans freshness, de sorte qu’une source qui n’a pas pu être lue depuis un moment est visible sur chaque mesure qui en provient. freshness.state vaut :
| État | Signification |
|---|---|
| fresh | Lue avec succès dans un délai d’une fois et demie expected_refresh_seconds. |
| delayed | La dernière lecture réussie est plus ancienne, mais reste dans les limites de stale_after_seconds. |
| stale | La dernière lecture réussie est plus ancienne que stale_after_seconds. L’enregistrement reflète ce que disait la source à last_successful_fetch ; il reste disponible, marqué stale. |
| source_unavailable | Trois lectures consécutives ou plus ont échoué. |
| parse_error | La source a répondu, mais la dernière lecture n’a pas pu être traitée. |
| needs_review | La dernière lecture est en attente de vérification avant publication. |
| disabled | La source est désactivée. |
| never_run | La source est activée, mais n’a pas encore été lue. |
provenance.last_checked_at est la dernière lecture de la source où elle disait toujours ceci ; provenance.source_last_modified_at est la date de modification déclarée par la source. Ce sont deux horloges différentes, et les deux sont servies. GET /v1/health liste les sources qui ne sont pas à jour.
Ce que cela signifie pour vous
- Filtrez avec
source=si votre usage exige une licence particulière, et lisezrights_modesur chaque ligne. - Conservez l’id et
links.official. Une mesure que la source ne publie plus reçoit unwithdrawn_atet sort des listes par défaut (include_withdrawn=truela fait réapparaître) ; le lien officiel pointe vers l’autorité, pas vers cette API. - Pour un enregistrement en
facts_only, renvoyez vers la page de l’autorité plutôt que d’en recopier le texte.