eConnect biedt SDK's en client libraries aan waarmee je sneller integreert met de PSB API. Daarnaast kun je de OpenAPI-specificatie (swagger.json) gebruiken om zelf een client te genereren in vrijwel elke programmeertaal.

Er zijn twee officieel ondersteunde SDK's beschikbaar op GitHub, onder de organisatie theinvoicingcompany:

Beide SDK's wrappen de PSB REST API en bieden typed methods voor de meestgebruikte operaties: authenticatie, facturen verzenden en ontvangen, hooks beheren en partijgegevens opvragen.

De .NET SDK is beschikbaar als NuGet-package. Na installatie kun je met een paar regels code authenticeren en je eerste API-aanroep doen.

// Authenticatie en eerste aanroep met de .NET SDK
var client = new PsbClient(new PsbClientOptions
{
    ClientId = "jouw-client-id",
    ClientSecret = "jouw-client-secret",
    BaseUrl = "https://accp-psb.econnect.eu",
    IdentityUrl = "https://accp-identity.econnect.eu"
});

var me = await client.GetMeAsync();
Console.WriteLine($"Account: {me.Name}");

Tip: gebruik de acceptatie-URLs (accp-psb en accp-identity) tijdens ontwikkeling. Wissel naar de productie-URLs als je live gaat.

De PHP SDK installeer je via Composer. De SDK handelt OAuth-tokenmanagement automatisch af, zodat je je kunt richten op de business-logica.

// Authenticatie en eerste aanroep met de PHP SDK
$client = new \EConnect\Psb\PsbClient([
    'client_id' => 'jouw-client-id',
    'client_secret' => 'jouw-client-secret',
    'base_url' => 'https://accp-psb.econnect.eu',
    'identity_url' => 'https://accp-identity.econnect.eu',
]);

$me = $client->getMe();
echo "Account: " . $me->getName();

Werk je in een andere taal dan .NET of PHP? De PSB API is volledig gedocumenteerd als OpenAPI 3.0-specificatie. Je kunt de swagger.json downloaden vanaf psb.econnect.eu en daarmee een client genereren met OpenAPI Generator.

OpenAPI Generator ondersteunt meer dan 50 talen en frameworks, waaronder Java, Python, TypeScript, Go en Ruby. Een voorbeeld met de command-line tool:

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

Het resultaat is een volledige client library met typed models voor alle request- en responseobjecten. Je hoeft alleen nog de authenticatie in te richten (zie het authenticatie-artikel) en je kunt direct aan de slag.

Let op: gegenereerde clients bevatten standaard geen token-management. Implementeer zelf de logica om tokens op te vragen en te vernieuwen, of gebruik een OAuth2-library voor je platform.

De meest directe manier om de API te verkennen is via de Swagger UI op psb.econnect.eu. Daar kun je:

• Alle endpoints bekijken, gegroepeerd per functiegebied (SalesInvoice, PurchaseInvoice, Hook, Peppol, etc.)
• Request- en responseschema's inzien met alle velden en hun datatypes
• API-calls uitvoeren met je eigen Bearer token, direct vanuit de browser
• De swagger.json downloaden voor code-generatie

De Swagger UI is ook een handige referentie tijdens ontwikkeling. Als je twijfelt over de structuur van een request of de velden in een response, vind je daar altijd de actuele specificatie.

Gebruik je liever geen SDK? De PSB API is een standaard REST API die je kunt aanroepen met elke HTTP-client. Hieronder een voorbeeld met curl dat laat zien hoe je een token opvraagt en vervolgens je accountgegevens ophaalt:

# Token aanvragen
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')

# Accountgegevens ophalen
curl -s \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  https://accp-psb.econnect.eu/api/v1/me | jq .

In productietoepassingen is het verstandig om het token te cachen en pas te vernieuwen kort voordat het verloopt (na circa 3500 seconden). Vraag niet bij elk verzoek een nieuw token aan.