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.
# 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
Wat je kunt bouwen
Het meeste wat beheerders en gebruikers in vBoxxCloud doen, kan ook via de API.
Bestanden en mappen
Upload, download, verplaats, hernoem en vergrendel bestanden en mappen, en werk met eerdere versies.
Bekijk de endpointsDelen
Maak deellinks met een vervaldatum, downloadlimiet en ontvangers, en beheer met wie ze gedeeld zijn.
Bekijk de endpointsOrganisaties en beleid
Maak suborganisaties aan, stel opslagbeleid in en lees het gebruik uit. Handig voor partners die veel klanten beheren.
Bekijk de endpointsGebruikers, gasten en groepen
Maak accounts aan, wijzig en verwijder ze vanuit je eigen HR-systeem of gebruikersdirectory, en houd groepen gelijk.
Bekijk de endpointsApparaten en back-ups
Controleer desktopclients, koppel mappen op fileservers en maak of herstel back-ups.
Bekijk de endpointsActiviteit en gebruik
Lees het activiteitenlog en de gebruikscijfers uit voor rapportages, audits of je eigen monitoring.
Bekijk de endpointsAan de slag
- 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
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
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.
