Eén integratie. Daarna nooit meer over bronnen nadenken.
Elk endpoint antwoordt in dezelfde envelop, faalt in dezelfde vorm en pagina's op dezelfde manier — of het nu BAG, CBS of een catalogus-dataset is. Bouw de client één keer; nieuwe bronnen verschijnen zonder een regel code. En voor agents: het hele register als 111 MCP-tools.
Een contract om op te bouwen
Vier garanties waar uw code op kan leunen.
Vaste structuur (api, onderdeel, bron_type,
gegenereerd_op, duur_ms, integriteit, bronnen[], data), snake_case, ISO-8601,
RFC 7807-fouten. Eén parser, overal.
Waar/velden/sorteer/rijen/start op élke lijstrespons, plus ETag/304, gzip en Link-paginering — niet als optie maar als standaard.
111 MCP-tools over het hele register, één server-configuratie: uw chatbot of agent vraagt mee vanaf dag één, met dezelfde envelop als antwoord.
Geen accounts, geen sleutelbeheer, geen wachtlijst: frontends mogen direct, backend-afspraken met bronhouders regelen wij aan de achterkant.
De envelop, in het echt
Typ een willekeurig GET-pad en zie de respons in de standaard envelop binnenkomen — duur, integriteit en bronnen inclusief. Dit is precies wat uw client ontvangt.
Roep een endpoint aan
GET · opencurl https://Identix.org/v1/regio/GM0363/vergelijk?met=GM0599 # JSON, gzip, ETagDrie vragen, één verzoek
Een dashboard heeft vijf cijfers nodig? Vraag één keer. POST /v1/batch draait de calls server-side en levert ze samen op — één round-trip, één envelop.
Batch-demo
POST /v1/batchPOST /v1/batch
{ "aanvragen": [
{ "pad": "/v1/cbs/kerncijfers?regio=GM0363" },
{ "pad": "/v1/regio/GM0363/top?kenmerk=inwoners" },
{ "pad": "/v1/bekendmakingen/zoeken?q=%22woning%22" } ] }Rechtdoor in de stack
De volledige specificatie is machine-leesbaar: genereer uw typed client en laat de CI breken als het contract beweegt — niet uw gebruikers.
GET /openapi.yaml
MCP-server met 111 tools: adres, regio, wet, rechtspraak, Kamer — uw agent krijgt het hele register zonder één regel glue-code.
Identix.org/mcp
Waar/velden/sorteer op elke lijstrespons: laadt wat u nodig heeft, niet wat de bron toevallig teruggeeft.
?waar=gemeente=Amsterdam&velden=inwoners
Elke respons draagt zijn hash als ETag: monitors en webhooks halen alleen als er echt iets veranderde.
If-None-Match: "sha256:…"
Naast robots.txt een llms.txt: hoe AI-systemen dit platform mogen lezen en citeren — answer-engine-optimalisatie als endpoint.
GET /llms.txt
Bronnen verschijnen in het register en dus automatisch in uw client, de catalogus, llms.txt en MCP — upgraden zonder refactor.
GET /v1/bronnen
Alle endpoints: open, zonder account of sleutel. Limieten en rate-beleid staan in de documentatie; de envelop en foutvorm (RFC 7807) zijn hetzelfde op élke bron.