WWSrapport API examples

Integration examples for the WWSrapport API.

Official Links

• API overview and Swagger: wwsrapport.nl/api/docs
• OpenAPI JSON: wwsrapport.nl/api/openapi.json
• Request a partner account: wwsrapport.nl/api/toegang-aanvragen
• WWSrapport account and API keys: wwsrapport.nl/account
• GitHub organization: github.com/wwsrapport

These examples show how to:

• create a report with an Idempotency-Key;
• download report documents;
• verify webhook signatures;
• handle report lifecycle events.

Repositories

• PHP SDK: wwsrapport/php-client
• TypeScript SDK: wwsrapport/typescript-client
• Python SDK: wwsrapport/python-client
• .NET SDK: wwsrapport/dotnet-client

Environment

Copy .env.example to .env or export the variables in your shell:

export WWSRAPPORT_API_KEY="wwsr_live_..."
export WWSRAPPORT_WEBHOOK_SECRET="whsec_..."
export WWSRAPPORT_BASE_URL="https://wwsrapport.nl/v1"

Examples

PHP

cd php
composer install
php create-report.php
php download-report.php rpt_...
php -S localhost:8080 webhook-handler.php

TypeScript

cd typescript
pnpm install
pnpm create-report
pnpm download-report rpt_...
pnpm webhook

Python

cd python
python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
python create_report.py
python download_report.py rpt_...
python webhook_handler.py

.NET

cd dotnet
dotnet restore
dotnet run -- create-report
dotnet run -- download-report rpt_...
dotnet run -- download-advice rpt_...
dotnet run -- webhook

The .NET example uses the official Wwsrapport.Client package. When this repository is checked out next to wwsrapport/dotnet-client, the project automatically uses that local SDK project reference. In a standalone clone it falls back to the published NuGet package.

Webhook signature

WWSrapport signs webhook payloads using HMAC SHA-256:

v1 = HMAC_SHA256(secret, "{timestamp}.{raw_body}")

Validate these headers before processing an event:

• WWS-Webhook-Timestamp
• WWS-Webhook-Signature

Keep handlers idempotent. A webhook delivery can be retried.