Met de Users-endpoints haal je informatie op over de gebruikers binnen je account - bijvoorbeeld om gebruikersnamen aan een dashboard te koppelen of een eigen overzicht te bouwen.
Endpoints
| Methode | Pad | Beschrijving |
|---|---|---|
| GET | /api/v1/users | Lijst met alle gebruikers in je account |
| GET | /api/v1/users/{id} | Details van één gebruiker |
Lijst opvragen
GET /api/v1/users
Authorization: Bearer <token>
Accept: application/json
Eén gebruiker ophalen
GET /api/v1/users/42
Authorization: Bearer <token>
Response-velden
Per gebruiker krijg je:
- id - uniek ID
- first_name - voornaam
- last_name - achternaam
- email - e-mailadres (tevens inlognaam)
- active - true als de gebruiker actief is en kan inloggen
- locale - voorkeurstaal van de gebruiker (nl, en, etc.)
Voorbeeld-response
{
"data": [
{
"id": 1,
"first_name": "Anna",
"last_name": "Janssen",
"email": "anna@voorbeeld.nl",
"active": true,
"locale": "nl"
},
{
"id": 2,
"first_name": "Bart",
"last_name": "de Vries",
"email": "bart@voorbeeld.nl",
"active": false,
"locale": "en"
}
]
}
Gebruikssituaties
- Single Sign-On of provisioning: synchroniseer wie er toegang heeft tot Mach3Forms met je centrale gebruikersbeheer.
- Audit: rapporteer welke (geblokkeerde) gebruikers nog in je account staan.
- Eigen dashboard: toon namen van eigenaren bij vragenlijsten in een externe rapportage.
Veelgestelde vragen
Nee. Aanmaken, wijzigen of deactiveren doe je via de admin-omgeving (door een beheerder).
Ja, het active-veld geeft aan of de gebruiker kan inloggen. Filter zelf op active === true als je alleen actieve gebruikers wilt.
Nee. Rollen worden niet meegestuurd in deze response. Wil je weten welke gebruiker welke rechten heeft? Dat zie je via de admin-omgeving.