Organisatie

De organisatie is de centrale scope in jouw Topolab-account. API-sleutels, tegoeden, facturen en Data Studio behoren allemaal tot een organisatie, niet tot een individuele gebruiker.

Deze eindpunten worden aangeroepen namens een ingelogde gebruiker met een Bearer JWT. Zie Authenticatie voor hoe je de token kunt verkrijgen.

Waarom scoping belangrijk is

Een gebruiker kan tot meer dan één organisatie behoren. Bijna elke bron die je leest of creëert — sleutels, gebruik, facturering — wordt aangesproken met een organizationId. Los eerst de organisaties op waartoe je behoort, en gebruik vervolgens de juiste organizationId in de daaropvolgende aanroepen.

Bron	Scope
API-sleutels	Organisatie (persoonlijke sleutels zijn eigendom van jou binnen een org)
Tegoeden & gebruik	Organisatie
Facturen	Organisatie
Data Studio	Organisatie

Je organisaties opsommen

GET /v1/organization/me

Geeft de organisaties terug waartoe de ingelogde gebruiker behoort, met de rol van de gebruiker in elke organisatie.

curl -H "Authorization: Bearer eyJhbGci..." \
  "https://api.topolab.nl/v1/organization/me"

{
  "data": [
    {
      "id": "org_8f3a2c7e",
      "name": "Acme Geospatial BV",
      "role": "owner"
    },
    {
      "id": "org_1d4056a1",
      "name": "Acme Research",
      "role": "member"
    }
  ]
}

Veld	Beschrijving
data[].id	De organizationId die wordt gebruikt in sleutels, tegoeden en factuur-eindpunten.
data[].name	Weergavenaam van de organisatie.
data[].role	Jouw rol in de organisatie, bijvoorbeeld owner, admin of member.

Krijg een organisatieprofiel

GET /v1/organization/:id

Geeft het organisatieprofiel en haar leden terug. De ingelogde gebruiker moet een lid van de organisatie zijn.

curl -H "Authorization: Bearer eyJhbGci..." \
  "https://api.topolab.nl/v1/organization/org_8f3a2c7e"

{
  "id": "org_8f3a2c7e",
  "name": "Acme Geospatial BV",
  "members": [
    {
      "userId": "usr_a5b6c7d8",
      "email": "lead@acme.example",
      "role": "owner"
    },
    {
      "userId": "usr_e3f4a5b6",
      "email": "analyst@acme.example",
      "role": "member"
    }
  ]
}

Veld	Beschrijving
id	Organisatie-identificator.
name	Weergavenaam.
members[]	Gebruikers in de organisatie, met hun role.

Fouten

Status	Betekenis
401	Ontbrekende of ongeldige Bearer-token.
403	Je bent geen lid van de aangevraagde organisatie.
404	De organisatie bestaat niet.
429	Rate limited — zie Rate limits & credits.

Volgende

• API-sleutels — beheer sleutels binnen een organisatie.
• Gebruik statistieken — tegoed en API-gebruik per organisatie.
• Facturen — facturatiedocumenten voor een organisatie.
• Heb je een organisatie of meer plaatsen nodig? Neem contact met ons op.