Geen officiële SDK voor jouw taal? De PSB API is een OpenAPI 3.0-specificatie. Genereer daaruit een typed client.

1. Open de Swagger UI: psb.econnect.eu (acceptatie: host accp-psb.econnect.eu)
2. Download swagger.json, of gebruik de directe URL https://psb.econnect.eu/swagger/v1/swagger.json
3. Of gebruik de API Reference op deze site als interactieve gids naast je gegenereerde client

Voorbeeld met OpenAPI Generator:

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

Vervang -g python door o.a. go, java, typescript-fetch, csharp, rust, afhankelijk van je stack. Houd gegenereerde code onder versiebeheer of regenereer hem in CI bij elke spec-update.

De PSB gebruikt OAuth2 Bearer-tokens. Configureer token-URL en credentials zoals in Authenticatie:

• Acceptatie Identity: https://accp-identity.econnect.eu/connect/token
• Scope: ap
• Flow: Client Credentials (server-naar-server)

Gegenereerde clients bevatten geen tokenbeheer. Vraag zelf een Bearer-token aan. Het token is 3600 seconden geldig en er is geen refresh-token; vraag na circa 3500 seconden een nieuw token aan.

• Genereer tegen de acceptatie-spec / test met acceptatie-hosts
• Valideer XML eerst (Validator) voordat je verzend-endpoints aanroept
• Gebruik X-EConnect-DocumentId (UUID) voor idempotency bij uploads