Actualiteit zonder schijnzekerheid

Freshnessvelden zorgvuldig interpreteren

De API gebruikt meerdere tijdsvelden omdat een inhoudelijke peildatum, een broncontrole, een redactionele review en bundlegeneratie vier verschillende gebeurtenissen zijn.

Actualiteit

DatadataAsOf
BronsourceCheckedAt
ExportgeneratedAt

Inhoudelijke peildata en het technische exportmoment hebben ieder een eigen betekenis.

Vier velden, vier vragen

dataAsOf
Op welke inhoudelijke peildatum of periode hebben de gebruikte gegevens betrekking?
sourceCheckedAt
Wanneer is de gekoppelde bron gecontroleerd?
editorialReviewedAt
Wanneer is de redactionele duiding inhoudelijk beoordeeld?
generatedAt
Wanneer is de huidige bundle of responsebasis gegenereerd?

Velden zijn conditioneel. Ontbreekt een datum, verzin of kopieer dan geen andere datum als vervanging.

Voorbeeld: Volkswagen Golf

De live modelresponse gebruikte bij de gecontroleerde release de volgende envelopefreshness:

Freshness uit modeldetail

json

{
  "dataAsOf": "2026-08-01",
  "sourceCheckedAt": "2026-06-20",
  "editorialReviewedAt": "2026-06-25",
  "generatedAt": "2026-08-14T00:30:00.000Z"
}

dataAsOf zegt hier iets over de dataset, sourceCheckedAt over de broncontrole en editorialReviewedAt over de redactie. generatedAt beschrijft alleen het generatiemoment van de bundlebasis.

generatedAt is geen actualiteitsgarantie

Een consumer die feitelijke actualiteit wil beoordelen, kijkt eerst naar dataAsOf en sourceCheckedAt. Voor redactionele koopcontext is ook editorialReviewedAt relevant.

publishedAt hoort bij de release-identiteit: het zegt wanneer exact die bundle publiek beschikbaar werd, niet hoe actueel ieder feit daarin is. Een onbekend publicatiemoment blijft null en wordt niet gereconstrueerd uit generatedAt.

Statusregels verschillen per feitklasse

CURRENT, AGING, STALE en UNKNOWN zijn alleen verantwoord wanneer een feit aan een expliciete klasse en het juiste datumveld is gekoppeld. Een frequent wijzigende dataset krijgt andere grenzen dan voertuigregisterdata, regelgeving of redactionele modelcontext.

Statische definities krijgen zonder inhoudelijke aanleiding geen leeftijdsbadge. Zolang een record niet verantwoord aan een klasse is gekoppeld, blijft de status UNKNOWN; de API publiceert daarom nog geen generieke freshnessSummary op /v1/meta.

Fail-closed bij ontbrekende zekerheid

  • Onbekende detail-IDs leveren geen verzonnen kennisobject.
  • Ongeldige searchinput levert geen gegokte resultaten.
  • Searchresultaten kunnen NOT_EXPOSED_IN_SEARCH_INDEX tonen wanneer detailfreshness bewust niet in de compacte index staat.
  • De brandstofprijsroute kan SOURCE_REQUIRED_AT_RUNTIME tonen met een lege prices-array.

Lees alle publieke beperkingen