Lees eerst de API-identiteit
Gebruik /v1/meta om de actieve API-, schema- en knowledgeversie, populatie, scope en classificaties te lezen. Zo koppel je opgeslagen resultaten aan de release waaruit ze kwamen.
Vijf publieke GET-requests
bash
curl "https://api.kentekenkompas.nl/v1/meta"
curl "https://api.kentekenkompas.nl/v1/knowledge/search?q=Welke%20carrosserie%C3%ABn%20heeft%20de%20BMW%203-serie%3F&limit=5"
curl "https://api.kentekenkompas.nl/v1/models/volkswagen-golf"
curl "https://api.kentekenkompas.nl/v1/sources/rdw-open-data"
curl "https://api.kentekenkompas.nl/v1/terms/terugroepactie"JavaScript fetch
Een browser of JavaScript-runtime kan de publieke endpoint rechtstreeks benaderen. Controleer altijd eerst response.ok voordat je JSON verwerkt.
Meta ophalen met fetch
javascript
const response = await fetch("https://api.kentekenkompas.nl/v1/meta");
if (!response.ok) {
throw new Error(`API-response: ${response.status}`);
}
const meta = await response.json();
console.log(meta.knowledgeVersion);Lees de actieve release uit de response
De live /v1/meta-response is de bron voor knowledgeVersion, bundlehash, generatietijd en objectaantallen. Kopieer die waarden niet als vaste constanten naar een integratie of documentatiepagina.
Knowledge-responses gebruiken daarnaast een envelope die data scheidt van beschikbare evidence, sources, freshness en limitations. coverage en citationUrl zijn endpointspecifiek en staan niet in iedere response.
Natural-language search
URL-encode de waarde van q. De search accepteert 2 tot en met 200 invoertekens; limit ligt volgens OpenAPI tussen 1 en 25. Gebruik een detailendpoint wanneer je volledige freshness nodig hebt.
Search naar Volkswagen Golf
bash
curl "https://api.kentekenkompas.nl/v1/knowledge/search?q=Volkswagen%20Golf&limit=5"Model lookup
Haal stabiele identifiers eerst uit /v1/models. Een modeldetail bevat modelbrede kennis en context; bouwjaar, uitvoering, onderhoud en staat van een individuele auto blijven buiten deze lookup.
Volkswagen Golf modelkennis
bash
curl "https://api.kentekenkompas.nl/v1/models/volkswagen-golf"Source en term lookup
Een source-response beschrijft onderliggende provenance. Een term-response legt uit wat een voertuigbegrip wel en niet zegt. Behoud bij weergave altijd de classificatie, freshness en limitations die de response levert.
RDW Open Data provenance
bash
curl "https://api.kentekenkompas.nl/v1/sources/rdw-open-data"Term terugroepactie
bash
curl "https://api.kentekenkompas.nl/v1/terms/terugroepactie"HTTP-statussen en HEAD
| Status | Betekenis voor de integratie |
|---|---|
200 | De gevraagde representation is beschikbaar. |
304 | De representation is niet gewijzigd voor een geldige If-None-Match request. |
400 | De request is ongeldig, bijvoorbeeld door een ongeldige searchquery of limiet. |
404 | Een gevraagde model-, answer-, term- of source-ID bestaat niet publiek. |
414 | De request-URI is te lang. |
429 | De request is begrensd door de publieke service. |
503 | De knowledge release of benodigde data is tijdelijk niet beschikbaar. |
GET en HEAD zijn beschikbaar op alle veertien publieke routes. HEAD levert de headers zonder responsebody. Raadpleeg altijd OpenAPI voor de volledige responseset van de specifieke route.