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.