Ga naar inhoud

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.

Gemeten op 8 november 2026.

OnderdeelStand
GET /v1/openapi.json en GET /v1/scopes op api.prudai.comOp productie, openbaar
Account, gebruik, bronnen (lijst, zoeken en document ophalen) en gesprekkenOp productie, met een servicesleutel
Modellen, chat en kennisbankenBinnenkort, nog niet op productie te gebruiken
Citaten controlerenBinnenkort, staat op productie uit
prudai login met KeycloakOp productie (gemeten op 16 november 2026)
CLI prudai op npmOp npm als @prudai/cli (gemeten op 16 november 2026)
MCP-gateway mcp.prudai.comBinnenkort, gepland vanaf 12 november 2026
Goedkeuringen in de Prudai ConsoleOp productie, voor de schrijfacties die er staan (gesprekken)

Deze twee aanroepen zijn openbaar en werken zonder inloggen:

Terminal window
curl -s https://api.prudai.com/v1/scopes
curl -s https://api.prudai.com/v1/openapi.json

Met een servicesleutel:

Terminal window
curl -s https://api.prudai.com/v1/account \
-H "Authorization: Bearer $PRUDAI_TOKEN"
ProductReferentieToegang
LEO-familie: LEO, LEO Fiscaal, ZIA, VERA, BEVER en MAIAPrudai Developer APIVroege toegang
IRMAIRMA API (alleen voor Prudai-medewerkers, inloggen vereist), en openbaar: IRMA voor ontwikkelaarsReferentie niet publiek
ORDOORDO 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.

  • 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.