Skip to content
Ontwikkelaars

Bouw op vBoxxCloud

Koppel je eigen software aan vBoxxCloud met de REST API. Automatiseer gebruikers en organisaties, zet bestanden erin en haal ze eruit, maak deellinks en volg activiteit, op hetzelfde Europese platform dat je team al gebruikt.

Terminal
# 1. Get an access token (password grant: scripts under your own account)
curl -X POST https://web.vboxx.nl/oauth/token \
  -d grant_type=password \
  -d client_id=anchor \
  -d username=you@example.com \
  -d password='your-password'

# 2. Call the API with the token
curl https://web.vboxx.nl/api/2/person \
  -H "Authorization: Bearer <access_token>"
Basis-URL
https://web.vboxx.nl/api/2
Authenticatie
OAuth2-bearertokens
Tokens
Ongeveer een uur geldig, te vernieuwen met een refreshtoken
Verbinding
JSON, alleen via HTTPS

Aan de slag

  1. 1

    Registreer een applicatie

    Een beheerder opent de organisatie-instellingen, gaat naar API en kiest 'Register OAuth2 Client'. Je krijgt een client-ID en een client secret.

    Zo registreer je
  2. 2

    Vraag een toegangstoken aan

    Apps die namens andere gebruikers werken, sturen hen naar de toestemmingspagina (authorization code). Scripts onder je eigen account kunnen de password grant gebruiken.

    Toegangstokens
  3. 3

    Roep de API aan

    Stuur het token mee in de Authorization-header. Is het verlopen, vraag dan een nieuw token aan met het refreshtoken in plaats van opnieuw het wachtwoord te vragen.

    Verzoeken authenticeren

Goed om te weten

  • Gebruik voor koppelingen een apart account met alleen de rechten die nodig zijn. Zo zie je wat het doet en kun je de toegang intrekken.
  • Accounts met tweestapsverificatie sturen de code mee als auth_code wanneer ze een token aanvragen.
  • GET /api/2/version werkt zonder inloggen: een snelle manier om te testen of je de API bereikt.
  • Bewaar client secrets en refreshtokens zoals wachtwoorden: nooit in de browser of in de broncode.

Hulp nodig?

Ons supportteam in Nederland helpt met API-toegang, OAuth2-clients en koppelingen. Bouw je iets voor veel klanten? Bekijk dan het partnerprogramma.