Webhooks
job.ready wanneer de levering klaar is, met controle van X-Klicbot-Signature.
Vaak KLIC-meldingen nodig? Bekijk de voordelige creditbundels
Zodra de levering van een job klaar is, kan Klicbot een bericht sturen naar jouw systeem.
Je zet webhook_url op de job bij POST /api/v1/jobs. Dat mag met een PRO-sleutel. Alleen https, geen intern adres. Of je zet een adres in het dashboard onder Instellingen, API & integraties. Klicbot stuurt dan een POST met JSON.
Je antwoordt met een status tussen 200 en 299. Het verzoek wacht ongeveer 10 seconden.
Staat er een webhook_secret op het bedrijf, dan komt de header X-Klicbot-Signature mee. De waarde is sha256= plus de HMAC-SHA256 van de ruwe body, met dat geheim.
Gebeurtenis voor een koppeling
| Gebeurtenis | Wanneer |
|---|---|
job.ready |
De job is ready. In testmodus is dat direct na POST /jobs/{job_id}/test-pay |
project.completed en checklist.completed horen bij het dashboard-adres, niet bij webhook_url op een job.
Voorbeeld webhook job.ready
company_id, timestamp en job_id zijn van jouw job. dossier_url is de aanbevolen levering: de viewer met de eis voorzorgsmaatregelen, voor die ene order. De GIS-paden blijven extra downloads.
{
"event": "job.ready",
"company_id": "cmp_voorbeeld",
"company_name": "Voorbeeld",
"timestamp": "2026-11-14T08:00:00+00:00",
"data": {
"job_id": "GIS-VOORBEELD",
"status": "ready",
"klic_type": "ORIENT",
"reference": "pilot-bunnik",
"client_ref": null,
"order_ids": ["TEST-GIS-VOORBEELD"],
"part_count": 1,
"is_test": true,
"geojson_url": "https://klicbot.nl/api/v1/jobs/GIS-VOORBEELD/geojson",
"shp_url": "https://klicbot.nl/api/v1/jobs/GIS-VOORBEELD/export?format=shp",
"gpkg_url": "https://klicbot.nl/api/v1/jobs/GIS-VOORBEELD/export?format=gpkg",
"dossier_url": "https://klicbot.nl/s/ORDER/token",
"dossier_label": "Bekijk je KLIC-melding"
}
}
Handtekening controleren
Python:
import hashlib
import hmac
def verify(secret: str, body: bytes, header: str) -> bool:
expected = "sha256=" + hmac.new(secret.encode("utf-8"), body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, header or "")
JavaScript:
const crypto = require("crypto");
function verify(secret, body, header) {
const expected = "sha256=" + crypto.createHmac("sha256", secret).update(body).digest("hex");
const a = Buffer.from(expected);
const b = Buffer.from(header || "");
return a.length === b.length && crypto.timingSafeEqual(a, b);
}
Gebruik de ruwe bytes van de body, niet een opnieuw geformatteerd object.
Verder lezen
Wat de API doet
Een PRO-account vraagt een prijs, betaalt en haalt de levering van de eigen KLIC-melding op.
Begrippen
Status van een job, de sleutel, testmodus en de velden op een prijs.
Eerste verzoek
Sleutel, prijs, testbetaling, status en levering. In curl, JavaScript en Python.
Paden
Elk pad van API versie 1, met het account dat het mag aanroepen.
ChatGPT en Claude
Koppel ChatGPT of Claude. Een adres opent de bewerkbare kaart. Je logt in met je Klicbot-account, of je gebruikt een API-sleutel.
Maak nu gratis een KLICBOT PRO-account aan voor jouw organisatie