API-sleutels en rechten (scopes)
Een API-sleutel hoort bij een afdeling of team, opent alleen de API's die u aanvinkt, heeft alleen de rechten (scopes) die u noemt en verloopt vanzelf. Een endpoint kan een extra recht eisen. U geeft een sleutel uit zonder dat recht en ziet 403, voegt het toe en ziet 200, en trekt de sleutel in: 401.
Open uw ontwikkelomgeving
Klik in de portal bij Omgevingen op Ontwikkeling, en daar op Openen. Flow opent in een nieuw tabblad, en u bent meteen ingelogd.
- Klik op Ontwikkeling
- Klik op Openen ↗
Geef een sleutel uit
Onder Beveiliging → API-sleutels klikt u ＋ Nieuwe sleutel. Geef hem een naam die zegt voor wie en waarvoor, een eigenaar, en vink alleen de API aan die hij mag openen. Rechten laat u hier nog leeg. Hij verloopt na de gekozen termijn.
- Klik op Beveiliging
- Klik op API-sleutels
- Klik op ＋ Nieuwe sleutel
- Vul in bij Naam:
Dealer Noord → onderdelen
- Klik op Onderdelen
- Klik op 90 dagen
- Klik op Sleutel uitgeven
- Klik op Klaar, ik heb hem bewaard
Zonder het recht: 403
Het endpoint eist het recht onderdelen:lezen. De sleutel opent de API wel, maar heeft dat recht niet: de gateway antwoordt 403 Onvoldoende scope en de workflow draait niet.
- Klik op het endpoint
- Vul in bij Sleutel of token:
••••••••
- Klik op ▶ Verstuur
Geef het recht en probeer opnieuw
Bewerk de sleutel en vul bij Rechten (scopes) onderdelen:lezen in. De sleutel zelf blijft dezelfde: de afnemer hoeft niets te veranderen. Nu antwoordt het endpoint 200.
- Klik op Beveiliging
- Klik op API-sleutels
- Klik op Bewerken
- Vul in bij Rechten (scopes):
onderdelen:lezen
- Klik op Opslaan
- Klik op het endpoint
- Vul in bij Sleutel of token:
••••••••
- Klik op ▶ Verstuur
Trek de sleutel in
Stopt een afnemer, of is een sleutel uitgelekt? Intrekken werkt direct: elke volgende aanroep krijgt 401. Wilt u een sleutel juist vervangen zonder onderbreking, kies dan Vernieuwen: de oude blijft nog even werken.
- Klik op Beveiliging
- Klik op API-sleutels
- Klik op Intrekken
- Klik op Intrekken
- Klik op het endpoint
- Vul in bij Sleutel of token:
••••••••
- Klik op ▶ Verstuur
Deze handleiding is op 22 okt 2026 stap voor stap uitgevoerd door een geautomatiseerde test op Flow (versie 3e563176).