Prudai voor ontwikkelaars
Alles wat je nodig hebt om op Prudai te bouwen: de API per product, inloggen, scopes, goedkeuringen, fouten, servicesleutels, de CLI en MCP. De API-referenties zijn gegenereerd uit de OpenAPI-specificatie van elk product.
Wat vandaag werkt
Section titled “Wat vandaag werkt”Gemeten op 8 november 2026.
| Onderdeel | Stand |
|---|---|
GET /v1/openapi.json en GET /v1/scopes op api.prudai.com | Op productie, openbaar |
| Account, gebruik, bronnen (lijst, zoeken en document ophalen) en gesprekken | Op productie, met een servicesleutel |
| Modellen, chat en kennisbanken | Binnenkort, nog niet op productie te gebruiken |
| Citaten controleren | Binnenkort, staat op productie uit |
prudai login met Keycloak | Op productie (gemeten op 16 november 2026) |
CLI prudai op npm | Op npm als @prudai/cli (gemeten op 16 november 2026) |
MCP-gateway mcp.prudai.com | Binnenkort, gepland vanaf 12 november 2026 |
| Goedkeuringen in de Prudai Console | Op productie, voor de schrijfacties die er staan (gesprekken) |
Probeer het
Section titled “Probeer het”Deze twee aanroepen zijn openbaar en werken zonder inloggen:
curl -s https://api.prudai.com/v1/scopescurl -s https://api.prudai.com/v1/openapi.jsonMet een servicesleutel:
curl -s https://api.prudai.com/v1/account \ -H "Authorization: Bearer $PRUDAI_TOKEN"API per product
Section titled “API per product”| Product | Referentie | Toegang |
|---|---|---|
| LEO-familie: LEO, LEO Fiscaal, ZIA, VERA, BEVER en MAIA | Prudai Developer API | Vroege toegang |
| IRMA | IRMA API (alleen voor Prudai-medewerkers, inloggen vereist), en openbaar: IRMA voor ontwikkelaars | Referentie niet publiek |
| ORDO | ORDO API (alleen voor Prudai-medewerkers, inloggen vereist) | Referentie niet publiek |
Elke operatie staat in de referentie met haar scope, haar goedkeuringsniveau en voorbeelden in curl en CLI.
De basis
Section titled “De basis”- Inloggen: één identiteit via Keycloak, met per product een kortlevend token.
- Scopes en rechten: elke operatie vraagt een scope in de vorm
<product>:<object>:<read|write|delete>. - Goedkeuringen: een schrijfactie van een agent wacht op een mens.
- Fouten: een vaste string-code, een message en details.
- Servicesleutels:
prudai_sk_voor je eigen applicaties. - Conventies: de envelop, paginering, idempotentie, dry run, ETag en zacht verwijderen.
- CLI en MCP: dezelfde API vanaf de opdrachtregel en vanuit een assistent.