Endpoints

REST API v1 endpoints: requests, GeoJSON, GIS-jobs en API-key beheer.

Belangrijkste API Endpoints

Base: https://klicbot.nl/api/v1

Authenticatie: header X-API-Key. Product: KLICBOT API (GIS). MCP (/mcp) is optioneel voor AI-clients.

KLIC-aanvragen

Methode Pad Beschrijving
GET /requests Paginated lijst (page, page_size max 200)
GET /request/{order_id} Detail van één aanvraag
GET /request/{order_id}/geojson IMKL GeoJSON FeatureCollection

Vereist read-recht op de API-key.

GIS-jobs (partner / eigen GIS)

Methode Pad Beschrijving
POST /jobs Quote (default) of indienen. Met submit=true antwoordt de API met HTTP 202. Body: GeoJSON geometry, klic_type (ORIENT/GRAAF), optioneel crs, reference, client_ref (idempotent), address (BAG), webhook_url, start_date (verplicht bij GRAAF+submit)
GET /jobs Recente jobs van dit bedrijf
POST /jobs/{job_id}/submit Quote indienen (zelfde als submit=true; HTTP 202)
GET /jobs/{job_id} Status + next_action + deel-order_ids
GET /jobs/{job_id}/geojson Samengevoegde IMKL in RD New (EPSG:28992)
GET /jobs/{job_id}/export?format=shp Shapefile ZIP (RD New)
GET /jobs/{job_id}/export?format=gpkg GeoPackage (RD New, zelfde bytes als het dossier). 200 bestand + ETag/X-Klicbot-Sha256; 202 {status, poll_url, retry_after} als het artifact nog materialiseert (poll dezelfde URL). Een onbekend formaat zoals format=foo geeft 400 FORMAT_INVALID (shp | geojson | gpkg). 409 NOT_READY / EXPORT_FAILED.

Quote mag met read. Indienen vereist write. Antwoord 202 op submit betekent: geaccepteerd, Kadaster draait in de worker (niet wachten in de HTTP-request). GPKG-export draait niet inline op het API-proces: 200 als het artifact klaar is, anders 202. Foutcodes in detail.error_code (BILLING_REQUIRED = 402, tot factuur of eigen relatienummer staat). Webhook job.ready als alle delen geleverd zijn. Per-job webhook_url of de company-URL onder Instellingen. Zelfde client_ref = zelfde job (geen dubbele aanvraag).

API-key beheer

Methode Pad Beschrijving
POST /keys Nieuwe key (name, optioneel permissions, expires_in_days)
GET /keys Keys van de company
DELETE /keys/{key_id} Key intrekken

Key-beheer vereist admin-recht op de aanroepende key. Permissions: read, write, admin.

Dashboard (sessie-auth, geen API-key)

Uitgebreide operaties zoals compliance, exports en projecten lopen via het ingelogde dashboard:

https://klicbot.nl/dashboard/api/...

Dat is geen publieke REST-contract voor partners; gebruik /api/v1 of MCP voor integraties.

Niet beschikbaar in v1

  • Checklist- of CROW-mutaties
  • Graafmelding zonder HAS/start_date (WIBON)

Pilot GIS: oriëntatie + export is de geautomatiseerde keten. API-toegang is gratis. Geen abonnement. Indienen betaalt per KLIC-melding, via factuur of eigen Kadaster-relatienummer.

Maatwerk of roadmap: contact@klicbot.nl.

API Overview

REST API v1 voor GIS en ERP. Gratis toegang, geen abonnement. Je betaalt per KLIC-melding. Met een API-key haal je aanvragen en GeoJSON op, of je stuurt een polygoon in.

Core Concepts

Kernconcepten in de KLICBOT API. Aanvraag, order_id, project en wat wél/niet in REST v1 zit.

Getting Started

Start met de REST API v1. Toegang is gratis, geen abonnement. Je betaalt per KLIC-melding. API-key aanmaken en eerste GET-request.

MCP Server

MCP-server voor AI-clients. Tools en resources via https://klicbot.nl/mcp. GIS gebruikt REST, niet MCP.

Webhooks

Outbound webhooks: project.completed, checklist.completed en job.ready.