Ga naar inhoud

Gebruikers

Accountscope vereist; voeg de header X-Auth-Account toe met je Account-ID. Deze endpoints zijn niet beschikbaar via OAuth. Het aanmaken, bijwerken en verwijderen van gebruikers vereist een admin-rol op het account, en het account moet een reseller zijn.

Gebruikers opvragen

Vraag alle gebruikers op die aan je account zijn gekoppeld.

GET /api/users

Teruggegeven params
  • users: Array
    • id: String
    • fname: String
    • lname: String
    • email: String
    • account_brand_id: Integer
    • locale: String
    • created_at: DateTime
    • updated_at: DateTime

Gebruiker bekijken

Bekijk een gebruiker.

GET /api/users/:id

Teruggegeven params
  • user: Object
    • id: String
    • fname: String
    • lname: String
    • email: String
    • account_brand_id: Integer
    • locale: String
    • created_at: DateTime
    • updated_at: DateTime

Een gebruiker aanmaken

POST /api/users

Dit maakt een gebruiker aan (en een nieuw sub-account) onder het huidige account. Vereist een reseller-account; aanmaken vanuit een SuperSpace-adminaccount geeft 422 terug.

Params
  • user: Object
    • fname: String (required)
    • lname: String (required)
    • email: String (required)
    • company_name: String | Dit wordt de accountnaam.
    • locale: String | en of nl
    • billing_term: String | monthly of annual
Teruggegeven params
  • user: Object
    • id: String
    • fname: String
    • lname: String
    • email: String
    • created_at: DateTime
    • updated_at: DateTime
    • password: String | Wordt alleen bij het aanmaken teruggegeven.
    • account_id: String
    • api_token: String | Wordt alleen bij het aanmaken teruggegeven.

password en api_token worden alleen in deze create-response teruggegeven — sla ze meteen op. Gebruik de teruggegeven API-credentials om je voortaan als die gebruiker te authenticeren.

Een gebruiker bijwerken / verwijderen

PATCH /api/users/:id en DELETE /api/users/:id zijn niet toegestaan en geven 401 terug.