Ketenafspraken: feedback, correctie, chunking, transport, releases
Transport en beveiliging: REST, OAuth 2.0, mTLS, x-api-key en x-jws-signature
VB-PUO gebruikt uitsluitend RESTful API's over HTTPS in een push-model: de verzender neemt het initiatief. Sinds de definitieve Release 2027 is OAuth 2.0 (client credentials) het vaste authenticatiemechanisme en is tweezijdige TLS (mTLS) het uitgangspunt. Een API-sleutel in de x-api-key-header en een digitale handtekening in de x-jws-signature-header zijn opties (handleiding §2.7 en §7.4).
Stappen
- InrichtingBeide partijenWissel endpoints, OAuth-clients (client credentials) en certificaten uit, en API-sleutels als partijen die optie gebruiken; leg de OAS-versie vast (1.0.11 bij Release 2027).
- VerzendenVerzenderPOST van het JSON-bericht met een OAuth 2.0-bearer-token, optioneel met x-api-key en x-jws-signature.
- OntvangenOntvangerVerifieer een eventuele handtekening, valideer tegen het schema van de opgegeven afdDefinitionVersion en antwoord volgens de zes feedbackpatronen. feedback
Regels en verbandscontroles
- Andere transportvormen (bestanden, e-mail) worden door de standaard niet ondersteund.
- GitHub-issues #102 en #143 gaan over mTLS-inrichting; #106 over API-versionering.
Bron: Handleiding paragraaf 2.7 en 7.4