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_INDEXtonen wanneer detailfreshness bewust niet in de compacte index staat. - De brandstofprijsroute kan
SOURCE_REQUIRED_AT_RUNTIMEtonen met een legeprices-array.
