SIA Intelligence API

Aanroep

curl -X POST https://sia.example.com/api/v1/intelligence \
  -H "Authorization: Bearer sia_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "case_date": "2026-09-10",
      "absence_day": 62,
      "description": "Een medewerker is op 10 juli uitgevallen na een conflict met zijn leidinggevende over de roosterindeling. Er is nog geen plan van aanpak opgesteld.",
      "previous_interventions": [
          "Gesprek met HR op 24 juli"
      ],
      "manager_context": "De leidinggevende wil een vaststellingsovereenkomst bespreken.",
      "occupational_health_status": "Spreekuur op 5 augustus; geen medische beperkingen.",
      "language": "nl",
      "reference": "WT-0447",
      "employee_role": "magazijnmedewerker"
  }'

Antwoord

{
  "case_id": "2d83f619-e968-489d-935a-362f6907de11",
  "category": "expert_judgement_required",
  "assessment": "Op verzuimdag 62 ontbreekt het plan van aanpak, terwijl het spreekuur van de bedrijfsarts op 5 augustus vermoedelijk aanleiding gaf om dit uiterlijk twee weken later op te stellen.",
  "reasoning": "De wettelijke termijn is twee weken na het oordeel van de bedrijfsarts wanneer er mogelijkheden zijn om terugkeer naar arbeid te bevorderen [3]. Omdat niet duidelijk is of op 5 augustus een formele probleemanalyse of schriftelijk oordeel is uitgebracht, is de precieze grondslag van de termijn nog te bevestigen.",
  "action": "Stel vandaag samen met de werknemer een schriftelijk plan van aanpak op en leg de afzonderlijke vraag over de vaststellingsovereenkomst ter beoordeling voor aan een SIA-expert (SIA Expert Review).",
  "deadline": {
    "date": "2026-09-10",
    "label": "Onverwijld herstellen van het ontbrekende plan van aanpak",
    "days_from_case_date": 0
  },
  "risk": "Zonder actie blijven concrete re-integratiedoelen, termijnen, evaluatieafspraken en verantwoordelijkheden ontbreken en blijft het re-integratiedossier onvolledig.",
  "sources": [
    {
      "title": "Regeling procesgang eerste en tweede ziektejaar",
      "version": "2025-07-01",
      "article": "Regeling procesgang eerste ziektejaar > Artikel 4. Het plan van aanpak",
      "status": "legal_requirement"
    },
    {
      "title": "Werkwijzer Poortwachter",
      "version": "2022-08-01",
      "article": "3.2 Onderdelen re-integratieverslag",
      "status": "official_guidance"
    }
  ],
  "confidence": "medium",
  "escalation": {
    "required": true,
    "reason": "Het bespreken en beoordelen van een vaststellingsovereenkomst vraagt om menselijke juridische beoordeling door een SIA-expert en moet gescheiden blijven van de verzuimbegeleiding.",
    "to": "expert_review"
  },
  "missing_information": [
    "Is op 5 augustus een formele probleemanalyse of een schriftelijk advies van de bedrijfsarts uitgebracht?",
    "Ligt er al een concreet voorstel voor een vaststellingsovereenkomst?"
  ],
  "ai_generated": true,
  "ai_notice": "Gegenereerd door SIA, een AI-systeem. Dit is een advies, geen besluit: een mens beoordeelt het voordat er iets gebeurt. Geen medisch of juridisch advies.",
  "ai_blocks": ["category", "assessment", "reasoning", "action", "deadline", "risk", "confidence", "escalation", "missing_information"],
  "credits": {
    "charged": 0,
    "balance": 1220
  }
}

Aanroep met Idempotency-Key

curl -X POST https://sia.example.com/api/v1/intelligence \
  -H "Authorization: Bearer sia_YOUR_KEY" \
  -H "Idempotency-Key: 6f1d2c0e-4b8a-4e59-9a3b-2f7c1d9e8a41" \
  -H "Content-Type: application/json" \
  -d @case.json

Node.js

import { createHmac, timingSafeEqual } from 'node:crypto';

// rawBody: the request body exactly as received, before JSON.parse.
export function verifySia(rawBody, header, secret, toleranceSeconds = 300) {
  const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
  const t = Number(parts.t);
  if (!Number.isInteger(t) || Math.abs(Date.now() / 1000 - t) > toleranceSeconds) return false;
  const expected = createHmac('sha256', secret).update(`${t}.${rawBody}`).digest();
  const given = Buffer.from(parts.v1 ?? '', 'hex');
  return given.length === expected.length && timingSafeEqual(given, expected);
}

Python

import hashlib, hmac, time

# raw_body: the request body as bytes, exactly as received.
def verify_sia(raw_body: bytes, header: str, secret: str, tolerance: int = 300) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(","))
    t = int(parts.get("t", "0"))
    if abs(time.time() - t) > tolerance:
        return False
    signed = f"{t}.".encode() + raw_body
    expected = hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, parts.get("v1", ""))