Developers / Scans API
Scans API
Analyses starten, status pollen, resultaten ophalen, feedback sturen.
POST /v1/scans
Start een analyse voor de authenticatie-organisatie.
Auth: cookie of Bearer-key · Telt mee voor: scanquota + opslag
{
"inputType": "text",
"text": "Minstens 30 tekens…",
"mode": "Standard",
"language": "Auto detect",
"modelId": "optioneel-model-id"
}Ook inputType: "url" met url, of multipart document (file + JSON metadata).
Response: Scan met id en status.
Fouten: 401 · 402 planlimiet · 400 validatie
GET /v1/scans
Lijst scans van jouw organisatie.
GET /v1/scans/:id
Eén scan. Poll tot complete of failed.
GET /v1/scans/:id/result
Kansen, classificatie, segmenten, signalen, modelversie.
DELETE /v1/scans/:id
Verwijdert scan + resultaat (maakt opslag vrij).
POST /v1/scans/:id/feedback
{
"correct": "yes" | "no" | "",
"label": "AI" | "Human" | "Mixed" | "Unknown",
"generatorModel": "Unknown",
"consentForTraining": false
}Feedback zet training nooit aan tenzij consentForTraining expliciet true is.