OpenAPI codegen

Genereer een PSB API-client in Python, Go, Java, TypeScript of een andere taal uit de eConnect swagger.json.

Geen officiƫle SDK voor jouw taal? Genereer een typed client uit de OpenAPI-spec.

Spec ophalen
  1. Open de Swagger UI: psb.econnect.eu (acceptatie: host accp-psb.econnect.eu)
  2. Download swagger.json
  3. Of gebruik de API Reference op deze site als interactieve gids naast je gegenereerde client
Client genereren

Voorbeeld met OpenAPI Generator:

openapi-generator-cli generate \
  -i 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.

Authenticatie in de gegenereerde client

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)
Tips
  • 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