Voor softwareleveranciers

WOZ-waarden in je eigen software, zonder dat het jou iets kost

Bouw eenmalig een OAuth-koppeling. Jouw klanten koppelen hun eigen WozApi-account, betalen hun eigen credits en jij levert de feature: actuele WOZ-waarden bij elk object, met 1 GET-request per object of verhuurbare eenheid.

Kosten voor jou
€ 0
Jouw klant betaalt
vanaf € 0,35 per uniek adres
Standaard
OAuth 2.0, authorization code + PKCE
Per object
1 GET-request
Doorloop de demo als jouw klant Vraag client-credentials aan

Zo werkt het voor jouw klant

De hele onboarding is gebouwd op zo min mogelijk frictie: geen wachtwoord, geen creditcard, en met 10 gratis startcredits werkt de koppeling meteen.

Geef je bij de redirect het aantal objecten mee, dan helpt de onboarding je klant actief: die ziet dan bijvoorbeeld "Jouw software gaf aan dat je 600 objecten hebt; we raden 600 credits aan (€ 227 excl. btw)", met de vrijheid om zelf meer of minder te kiezen of het over te slaan.

Wat jij bouwt: drie requests

Standaard OAuth 2.0 met PKCE, dus elke OAuth-client-library werkt. Discovery staat op /.well-known/openid-configuration. 

# 1. Stuur je klant naar het authorize-endpoint (browser-redirect)
https://woz-api.nl/connect/authorize?client_id=JOUW_CLIENT_ID
  &response_type=code&redirect_uri=https://jouwsoftware.nl/wozapi/callback
  &scope=woz.lookup%20account.saldo%20offline_access
  &state=RANDOM&code_challenge=S256_CHALLENGE&code_challenge_method=S256
  &login_hint=klant@voorbeeld.nl&objecten=600

# 2. Wissel de code in voor tokens (server-side)
curl -X POST https://woz-api.nl/connect/token \
  -d grant_type=authorization_code -d code=DE_CODE \
  -d redirect_uri=https://jouwsoftware.nl/wozapi/callback \
  -d client_id=JOUW_CLIENT_ID -d client_secret=JOUW_SECRET \
  -d code_verifier=DE_VERIFIER

# 3. Haal per object de WOZ-waarde op, op de credits van je klant
curl "https://woz-api.nl/Api/Adres?adres=Spuistraat%2036C,%201012TT%20Amsterdam" \
  -H "Authorization: Bearer ACCESS_TOKEN"
  • Access tokens zijn 60 minuten geldig; met de scope offline_access krijg je een refresh token (90 dagen, roterend).
  • Het saldo van de klant komt bij elke geslaagde call mee in de header X-Credits-Remaining; los opvragen kan via GET /Api/Credits.
  • Saldo op? Dan geeft de API HTTP 402: toon een knop naar https://woz-api.nl/Account/Billing zodat je klant direct kan opwaarderen.
  • De klant kan de koppeling altijd zelf verbreken onder Account, Koppelingen; jouw tokens werken dan direct niet meer.

Waarom dit model prettig is voor jou

  • Geen inkoop, geen bundels, geen doorbelasting: je klant rekent zelf af bij WozApi
  • Geen prijsrisico en geen facturatiewerk; jij levert alleen de feature
  • Geen persoonsgegevens van ons om te bewaren, dus ook geen verwerkersovereenkomst nodig
  • Demo werkt direct: elk nieuw account heeft 10 gratis credits
  • Eén integratie voor al je klanten, met standaard OAuth-tooling

Wil je de kosten liever zelf dragen? Dat kan vandaag al met een gewoon WozApi-account met API-key: jij doet de calls server-side op eigen saldo. De koppeling hierboven is de aanrader zodra je klanten zelf willen afrekenen.

Veelgestelde vragen

Wat kost de koppeling voor mij als softwareleverancier?

Niets. Je klant maakt een eigen WozApi-account en betaalt zijn eigen credits (vanaf EUR 0,35 per uniek adres, excl. btw). Jij bouwt alleen de OAuth-koppeling; er is geen inkoop, geen bundel en geen doorbelasting.

Hoe frictieloos is de onboarding voor mijn klant?

Je klant klikt in jouw software op de koppelknop, vult alleen zijn e-mailadres in (of dat staat al klaar via de login_hint die jij meegeeft), voert de code uit zijn mail in en geeft toestemming. Een wachtwoord is niet nodig, en met 10 gratis startcredits werkt de koppeling direct, nog voor er betaald is.

Welke gegevens ziet mijn software van de klant?

Alleen de WOZ- en adresgegevens die je opvraagt en, als je die scope vraagt, het creditsaldo. Accountgegevens, facturen of betaalgegevens krijg je nooit. Omdat je klant rechtstreeks klant is bij WozApi is er ook geen verwerkersovereenkomst tussen jou en ons nodig.

Wat gebeurt er als het saldo van mijn klant op is?

De API geeft dan HTTP 402. Je toont een knop naar het WozApi-account van je klant om op te waarderen; het actuele saldo krijg je bij elke call gratis mee in de header X-Credits-Remaining.

Hoe test ik de koppeling tijdens het bouwen?

Doorloop eerst de demo op deze site. Voor je eigen client registreren we ook localhost-redirect-URI's, en elk nieuw testaccount heeft 10 gratis credits. Een aparte sandbox is daardoor niet nodig.

Kan ik als leverancier ook zelf de credits betalen?

Dat kan vandaag al zonder koppeling: neem een gewoon WozApi-account met API-key en doe de calls server-side op eigen saldo. De OAuth-koppeling is de aanrader wanneer je klanten zelf willen afrekenen en jij geen prijsrisico of facturatiewerk wilt.

Vraag je client-credentials aan

Vertel kort wat je software doet en welke redirect-URI's je nodig hebt. Je ontvangt je client_id en secret binnen 1 werkdag, met de integratiestappen erbij.

Eerst zelf voelen hoe makkelijk het is?

Doorloop de koppeling in Blokvast, onze fictieve verhuurdersoftware, precies zoals jouw klant hem doorloopt: account, creditadvies, toestemming en een live WOZ-waarde.

Start de demo