Modelkennis is geen inspectie van een individueel voertuig
Een modelresponse beschrijft modelbrede kennis, openbare context en redactionele aandachtspunten. Zij bewijst niets over de concrete technische staat, schade, het onderhoud of de uitvoering van één auto.
Laat in een consumenteninterface daarom ruimte voor bouwjaar, uitvoering, onderhoudsbewijs, proefrit en zo nodig een aankoopkeuring.
Geen kentekenlookup
De Public Knowledge API heeft geen route voor kentekens of individuele voertuigen. De API-root maakt deze grens machineleesbaar met plateLookup: false.
Brandstofprijzen kunnen ontbreken
/v1/fuel-prices/latest beschrijft de status van de runtime bron. Zonder gevalideerde prijsimport blijft de response fail-closed met SOURCE_REQUIRED_AT_RUNTIME en zonder prijswaarden.
Ingekorte fail-closed fuelstatus
json
{
"status": "SOURCE_REQUIRED_AT_RUNTIME",
"prices": [],
"classification": "OFFICIAL",
"limitations": [
"generatedAt is geen prijsmeetdatum."
]
}Gebruik generatedAt nooit als meetdatum voor een prijs.
Deterministische search is geen confidence-model
Search gebruikt reproduceerbare lexicale ranking en expliciete intentregels. Een relevanceScore, tier of positie zegt hoe goed de query binnen die regels matcht; het is geen kansberekening en geen kwaliteitsbeoordeling van een voertuig.
Searchresultaten kunnen NOT_EXPOSED_IN_SEARCH_INDEX tonen voor freshness. Open dan het detailendpoint in plaats van een datum af te leiden.
Freshness is objectspecifiek
Niet ieder object heeft dezelfde combinatie van dataAsOf, sourceCheckedAt, editorialReviewedAt en generatedAt. Toon alleen velden die de response daadwerkelijk bevat en behoud hun afzonderlijke betekenis.
De publieke API blijft read-only
De veertien publieke routepaths ondersteunen GET en HEAD. Er zijn geen publieke schrijfoperaties in deze surface. Bouw geen interface die suggereert dat een consumer kennis, sources of voertuigdata via deze API kan wijzigen.