Modifications et versions

Versions et événements#

Chaque fois que le contenu d’une mesure change, une nouvelle version est écrite, avec les différences champ par champ par rapport à la précédente. Relire une source sans changement n’écrit rien : une version correspond donc toujours à un vrai changement. Chaque version produit un événement dans le flux, typé selon le changement le plus important et listant chaque catégorie touchée. Les versions sont conservées indéfiniment, les événements pendant 400 jours.

Le flux de modifications#

À partir de DeveloperGET /v1/changes demande la fonction change_feed.

$ curl "https://api.subsido.be/v1/changes?since=2026-09-01&type=subsidy.created,subsidy.deadline_changed&region=flanders" \  -H "Authorization: Bearer sb_live_..."

Les événements arrivent du plus ancien au plus récent, dans l’ordre de seq. La page est { data, pagination, meta }, et meta.latest_seq est le seq le plus récent de tout le flux : vous voyez ainsi votre retard.

{
  "id": "chg_06f8s2k1c9t4r7m3q5v0x8z2yw",
  "seq": 18422,
  "type": "subsidy.status_changed",
  "categories": [
    "subsidy.status_changed",
    "subsidy.deadline_changed"
  ],
  "subject": "subsidy",
  "subject_id": "eu:HORIZON-EIC-2026-ACCELERATOR-01",
  "version": 4,
  "changes": [
    {
      "field": "status",
      "before": "open",
      "after": "closed"
    },
    {
      "field": "application_window.closes_at",
      "before": "2026-10-01T17:00:00+02:00",
      "after": "2026-09-20T17:00:00+02:00"
    }
  ],
  "summary": {
    "title": {
      "nl": null,
      "fr": null,
      "en": "EIC Accelerator",
      "de": null
    },
    "status": "closed",
    "instrument_type": "grant",
    "issuer": "European Commission",
    "closes_at": "2026-09-20T17:00:00+02:00",
    "regions": [],
    "topics": [
      "innovation",
      "growth_scaleup"
    ],
    "url": "https://ec.europa.eu/info/funding-tenders/opportunities/portal/screen/opportunities/topic-details/HORIZON-EIC-2026-ACCELERATOR-01",
    "source_id": "eu_funding_tenders"
  },
  "occurred_at": "2026-09-27T06:12:40+02:00"
}

Types et catégories d’événements#

Le type principal d’une version est la catégorie la plus importante qu’elle touche, dans l’ordre statut, échéance, financement, éligibilité, mise à jour. Filtrez ou abonnez-vous sur une catégorie, pas seulement sur le type principal, sinon vous manquerez le changement d’échéance arrivé avec un changement de statut.

Différences par champ#

• field est un chemin pointé vers un champ terminal : status, application_window.closes_at, funding.amount_max, titles.nl. Les tableaux sont comparés en entier : une liste de régions modifiée est un seul changement, avec l’ancienne et la nouvelle liste.
• La liste des règles est comparée règle par règle sur leurs id : eligibility.rules[age_max] avec la règle avant et après (null si elle a été ajoutée ou retirée). Un changement de la seule provenance d’une règle, comme une nouvelle date de vérification, n’est pas un changement de la règle.
• Les champs de gestion sont versionnés mais jamais signalés : provenance.last_checked_at, provenance.content_hash, provenance.first_seen_at et provenance.fields. Une version qui ne diffère que par ces champs ne produit aucun événement.

Dates dépassées#

Chaque heure, nous normalisons à nouveau chaque fiche en vigueur par rapport à l’heure actuelle. Un appel dont l’échéance est passée devient closed, un appel annoncé qui s’est ouvert devient open, et closes_at passe à l’échéance suivante d’un appel en plusieurs phases. Chacun de ces changements est une nouvelle version, de cause date_passed, avec un événement ordinaire, en général subsidy.status_changed ou subsidy.deadline_changed. Le même passage horaire émet subsidy.closing_soon.

Suivre le flux#

Faites le premier appel avec since (ou sans, à partir du plus ancien événement conservé), puis suivez next_cursor. Chaque page en a un, la dernière comprise : quand has_more vaut false, vous êtes à jour, et ce même curseur est le point de départ de la prochaine interrogation. Enregistrez-le avec le travail qu’il couvre : un redémarrage reprend exactement là où il s’était arrêté.

Rien n’est sauté ni répété, même si une importation valide de nombreux événements à la fois et que des importations peuvent se chevaucher : un événement ne reçoit sa place dans le flux (son seq) qu’une fois validé, de sorte qu’un événement validé tard arrive après tout ce que vous avez déjà lu. Ni fenêtre de chevauchement ni liste d’id déjà vus ne sont nécessaires. seq donne l’ordre du flux ; occurred_at est le moment où le changement a été constaté, et peut être un peu plus ancien que celui d’un événement précédent.

let cursor = await loadCursor(); // null on the very first run

async function poll() {
  for (;;) {
    const url = new URL("https://api.subsido.be/v1/changes");
    url.searchParams.set("limit", "100");
    if (cursor) url.searchParams.set("cursor", cursor);
    else url.searchParams.set("since", "2026-09-01");
    const res = await fetch(url, {
      headers: { Authorization: `Bearer ${process.env.SUBSIDY_API_KEY}` },
    });
    const page = await res.json();
    if (!res.ok) throw new Error(page.error.code);
    for (const e of page.data) await handle(e);
    cursor = page.pagination.next_cursor; // always set
    await saveCursor(cursor);
    if (!page.pagination.has_more) return; // caught up; poll again later
  }
}

Versions et historique#

À partir de ProLes versions et as_of demandent les fonctions history et as_of.

GET /v1/subsidies/{id}/versions liste les versions d’une mesure, de la plus récente à la plus ancienne : { version, valid_from, valid_to, cause, content_hash, changes }. GET /v1/subsidies/{id}/versions/{version} renvoie la fiche telle qu’elle était, et GET /v1/subsidies/{id}?as_of= la version en vigueur à un instant donné. Des exemples figurent dans Rechercher des mesures.

Pourquoi une version a été écrite

Avec les versions et le flux, « qu’est-ce qui est ouvert ? » devient aussi « qu’est-ce qui a changé, quand, et que savait-on le jour de notre conseil ? ». Voir les tarifs.