De koppeling

Bijgewerkt 24 september 2026

Met een sleutel voor uw bureau levert u een dossier aan vanuit uw eigen software, vraagt u de stand op en haalt u het controlerapport op als pdf of als docx. Het rapport komt daarnaast gewoon per mail, net als bij het formulier. De koppeling hoort bij een abonnement en bij Onbeperkt.

Een sleutel aanvragen

Mail naar info@checkjequickscan.nl met de naam van uw bureau en het mailadres waarop de rapporten binnen moeten komen. U krijgt één sleutel per bureau. Bureau en mailadres liggen vast in de sleutel: wat ermee wordt aangeleverd, komt op naam van uw bureau en het rapport gaat naar dat adres, wat er verder ook wordt meegestuurd.

Voor een AI-assistent krijgt u desgewenst een tweede sleutel die alleen mag lezen: daarmee kan de assistent de stand en de bevindingen opvragen, maar niets aanleveren.

Bewaar de sleutel zoals een wachtwoord, en gebruik de sleutel alleen vanaf een server of een eigen computer, niet in een webpagina. Is de sleutel uitgelekt, mail ons dan: wij zetten de oude direct uit en u krijgt een nieuwe.

Aanleveren

Een dossier gaat als multipart/form-data naar POST /api/v1/dossiers op https://checkjequickscan-ontvangst.checkjequickscan-ontvangst.workers.dev, met de sleutel in de kopregel Authorization: Bearer <sleutel>. De velden:

dossier: Eén of meer pdf-bestanden: het rapport en de projectstukken. Maximaal twaalf, samen maximaal zestig megabyte.
naam: De naam van de opsteller.
adres: Waar het plangebied ligt.
gerechtigd: ja, als verklaring dat uw bureau het rapport zelf heeft opgesteld.
onderwerp: quickscan, nader onderzoek of activiteitenplan. Mag leeg blijven; dan wordt het onderwerp uit het rapport afgeleid.
hoofdbestand: De bestandsnaam van het rapport zelf, als u meer dan één pdf meestuurt. Mag leeg blijven.

curl https://checkjequickscan-ontvangst.checkjequickscan-ontvangst.workers.dev/api/v1/dossiers \
  -H "Authorization: Bearer $SLEUTEL" \
  -F naam="A. Jansen" -F adres="Dorpsstraat 1, Zeist" \
  -F gerechtigd=ja -F onderwerp=quickscan \
  -F dossier=@quickscan.pdf

Het antwoord noemt het kenmerk, waarmee u het dossier daarna terugvindt:

{"ok": true, "kenmerk": "2026-09-24-1a2b3c4d", "aantal": 1, "stand": "ontvangen"}

De stand

GET /api/v1/dossiers/<kenmerk> geeft de stand, met een reden als die er is:

ontvangen: Binnen en nog niet begonnen. Wachten wij op iets van uw kant, dan staat dat in de reden en in de mail.
in behandeling: De controle loopt.
klaar: Het controlerapport staat klaar.
geweigerd: Deze controle voeren wij niet uit. De reden staat erbij en in de mail.

Een controle is meestal binnen het uur klaar. Eens per minuut de stand opvragen is ruim voldoende.

Het rapport

GET /api/v1/dossiers/<kenmerk>/rapport geeft de pdf, en met ?vorm=docx de Word-versie, om in te werken. Is het rapport er nog niet, dan krijgt u de stand terug met status 409. Rapport en bevindingen staan tot zeven dagen na aflevering klaar; daarna zijn ze verwijderd, ook bij ons. Hoe dat zit, staat onder Privacy en bewaartermijn.

In een AI-assistent

Met dezelfde sleutel kan een AI-assistent die MCP ondersteunt de stand en de bevindingen opvragen, zodat u ze daar kunt doorlopen. Gebruik daar bij voorkeur de sleutel die alleen mag lezen. Het adres is https://checkjequickscan-ontvangst.checkjequickscan-ontvangst.workers.dev/mcp, met dezelfde kopregel. In Claude Code:

claude mcp add --transport http checkjequickscan \
  https://checkjequickscan-ontvangst.checkjequickscan-ontvangst.workers.dev/mcp \
  --header "Authorization: Bearer $SLEUTEL"

De assistent krijgt twee gereedschappen: controle_stand voor de stand van een dossier en controle_bevindingen voor de bevindingen, elk met ernst, bladzijde en citaat. Andere assistenten werken net zo, mits ze een eigen kopregel toestaan. Aanleveren gaat niet via de assistent maar via de API of het formulier.

Haalt u de bevindingen op in een AI-assistent, dan gaan ze naar de leverancier van die assistent. Dat valt onder uw eigen afspraken met die leverancier.

Grenzen

Per sleutel gaan er twintig dossiers per dag door de koppeling, en dertig aanroepen per minuut. Dat is een slot tegen een uitgelekte sleutel en geen grens op uw abonnement. Heeft u meer nodig, dan zetten wij de daggrens hoger, en via het formulier of per mail kunt u altijd aanleveren.

Foutmeldingen

Elk antwoord behalve het rapport zelf is JSON; een fout draagt een veld fout met de uitleg.

400: Er klopt iets niet aan de aanlevering, bijvoorbeeld een bestand dat geen pdf is. De melding zegt wat.
401: Geen sleutel, of een sleutel die niet (meer) geldt.
403: Deze sleutel mag dit niet, bijvoorbeeld aanleveren met een sleutel die alleen mag lezen.
404: Dit kenmerk bestaat niet voor uw bureau, of het dossier is ouder dan zeven dagen.
409: Het rapport is er nog niet.
413: De aanlevering is groter dan zestig megabyte.
429: Te veel aanroepen, of de daggrens is bereikt. Probeer het later opnieuw.