KLICBOT API – Core Concepts

Aanvraag (order_id)

In REST v1 is de aanvraag het centrale object: één KLIC-melding bij het Kadaster, geïdentificeerd door order_id. Lijst, detail en GeoJSON werken allemaal op dit id.

Project (dashboard)

Een project in het dashboard bundelt kaart, documenten, checklists en logboek. De publieke API adresseert projecten niet rechtstreeks; webhooks en GeoJSON gebruiken order_id. Voor projectbeheer: dashboard (sessie-auth).

KLIC-melding

De formele melding bij het Kadaster. In v1 verschijnt die als aanvraag in GET /requests. Nieuwe meldingen vanuit GIS gaan via POST /api/v1/jobs (GeoJSON-polygoon). Een melding start je ook op klicbot.nl of in het dashboard.

GIS-job

Een job is één GIS-aanroep: één polygoon (WGS84 of RD New), automatisch opgeknipt in Kadaster-tegels, na levering één samengevoegde GeoJSON/SHP. Identificatie: job_id. Webhook: job.ready.

CROW 500 & checklist

CROW 500-werkvoorbereiding (5 fasen, MP, WI, RDI) en checklists horen bij het PRO-dashboard, niet bij de publieke REST-API. Wel: bij afronden van een checklist kan een outbound webhook checklist.completed worden gestuurd. Zie Webhooks.

GeoJSON

GET /request/{order_id}/geojson levert de IMKL FeatureCollection van de levering (waar beschikbaar voor jouw tenant).

Wat niet in v1 zit

• Checklist-mutaties of CROW-keten
• Delivery-log voor webhooks in het dashboard (nog niet)
• HAS / graafmelding zonder start_date (WIBON). Oriëntatie en GIS-export kunnen dan wel end-to-end.

Zie Endpoints.