De PSB API is volledig beschreven als OpenAPI 3.0-specificatie. Werk je in een taal zonder officiële SDK (Python, Java, TypeScript, Go, Ruby, enz.), dan genereer je een typed client uit swagger.json.

De actuele specificatie is beschikbaar via:

• Swagger UI: psb.econnect.eu — download swagger.json via de knop bovenaan
• Directe URL: https://psb.econnect.eu/swagger/v1/swagger.json

In sommige omgevingen is een subscription key als queryparameter nodig:

https://psb.econnect.eu/v1/swagger.json?subscriptionKey={jouw-subscription-key}

De PSB-documentatie op psb.econnect.eu beschrijft dit patroon in de SDK-voorbeelden.

Installeer OpenAPI Generator CLI en kies een generator (-g) voor je taal:

openapi-generator-cli generate \
  -i https://psb.econnect.eu/swagger/v1/swagger.json \
  -g java \
  -o ./psb-client-java

Andere gangbare generators:

OpenAPI Generator ondersteunt meer dan 50 talen. Raadpleeg de generatorlijst voor opties per taal.

De PHP-SDK-repository toont codegen met aangepast package:

openapi-generator-cli generate \
  -g php \
  -i "https://psb.econnect.eu/v1/swagger.json?subscriptionKey={jouw-subscription}" \
  -o ./psb-client-php \
  --additional-properties=invokerPackage=EConnect\\Psb

Voor .NET-projecten is NSwag een alternatief naast het officiële EConnect.Psb-package:

nswag openapi2csclient /input:https://psb.econnect.eu/swagger/v1/swagger.json /output:PsbClient.cs

EConnect.Psb biedt daarnaast DI-registratie, tokenmanagement en webhook-validatie die een pure codegen-client niet heeft.

Gegenereerde clients bevatten standaard geen OAuth2-tokenmanagement. Je implementeert zelf:

1. Token ophalen via POST /connect/token op de Identity Server
2. Bearer token meesturen in de Authorization-header
3. Token vernieuwen vóór expiratie (tokens zijn circa een uur geldig)

Zie Authenticatie voor de Client Credentials- en Resource Owner-flows.

Voorbeeld met curl (basis voor je eigen token-logica):

TOKEN=$(curl -s -X POST https://accp-identity.econnect.eu/connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=jouw-client-id" \
  -d "client_secret=jouw-client-secret" \
  -d "scope=ap" | jq -r '.access_token')

In productie cache je het token en vernieuw je het pas kort vóór expiratie — niet bij elk API-verzoek.

Tijdens ontwikkeling is de Swagger UI handig om:

• Endpoints per functiegebied te verkennen (SalesInvoice, Hook, Peppol, enz.)
• Request- en responseschema's te bekijken
• Testcalls uit te voeren met je Bearer token