API · v3.3 · production · EU-region

De FieldOps API — voor wie integreert

REST-API voor Nederlandse infra-organisaties. CROW-conform · audit-bound · open standards.

📖 Swagger UI ReDoc OpenAPI 3.1 JSON 📄 Whitepaper
95+ endpoints 120+ tests passing OAuth 2.0 (Google + Microsoft) HMAC-SHA256 webhooks WebSocket realtime JWT auth (24h TTL)
Quick Start

Authenticatie in 3 stappen

# 1. Login → JWT-token curl -X POST https://portaal.fieldopsapp.nl/api/auth/login \ -H "Content-Type: application/json" \ -d '{"email":"jij@bedrijf.nl","password":"..."}' # Response: { "access_token": "eyJ...", "token_type": "bearer" } # 2. Authorize alle vervolg-calls curl https://portaal.fieldopsapp.nl/api/meldingen/ \ -H "Authorization: Bearer eyJ..." # 3. Of: probeer 't direct in Swagger UI → https://portaal.fieldopsapp.nl/docs
Drie-lagen Architectuur

API ingedeeld per laag

📱 Field Layer

Veldwerk capture vanaf mobiel: meldingen, assets, AI-inspecties met foto-upload.

/api/meldingen · /api/assets · /api/inspecties

🏛️ Compliance Layer

Audit-Bound AI™, predictive maintenance, job orchestration, onveranderlijk audit-log.

/api/audit · /api/predictive · /api/clusters

🔗 Integration Fabric

OAuth 2.0 (Google + Microsoft), HMAC-webhooks, WebSocket events, IoT-bridges.

/api/google · /api/microsoft · /api/webhooks
Compliance & Governance

Wat onder elke API-call ligt

🇳🇱 Norm-conformiteit

Live: CROW 146a/b · NEN 2767-2 · GWWkosten-RAW maatregel-namen.
Roadmap Q3-Q4: NEN 3399 · NEN 2767-4 · VTA · EN 1176 · ROVL.

🔐 Audit-Bound AI™

Elke AI-output: prompt_version, model_id, confidence, mens-acceptatie. Onveranderlijk in audit-log.

🏛️ Append-only audit-log

Per-event request_id, IP, actor, before/after-snapshot. Procurement-grade onderbouwing voor Rekenkamer.

🇪🇺 EU data-soevereiniteit

Alle data EU-Frankfurt hosting. Sub-processors gepubliceerd. AVG/GDPR-DPA template beschikbaar.

Integraties (live)

Open standards, geen ommuurde tuin

Slack (HMAC-webhook) Microsoft Teams (HMAC-webhook) Google Calendar v3 Google Drive v3 Microsoft Outlook (Graph) OneDrive (Graph) Web Push (VAPID) WebSocket realtime IoT webhook in Anthropic Claude vision CSV/MOR+ import
Voorbeeld

AI-melding aanmaken via API

# Upload foto + krijg CROW-classificatie curl -X POST https://portaal.fieldopsapp.nl/api/inspecties/analyse-foto \ -H "Authorization: Bearer eyJ..." \ -F "file=@scheur.jpg" \ -F "asset_type=wegdek" # Response (uitgekort): { "crow_klasse": "M2", "crow_schadebeeld": "scheurvorming-langs", "onderhoud_categorie": "KO", "gw_maatregel": "Vullen polymeer", "gw_kosten_orde": "€8–15 / m¹", "termijn_weken": 24, "prompt_version": "v2.0-crow", "model_id": "claude-sonnet-4-6", "confidence": 0.91 }