Authenticatie
- Authorization: ApiKey
- De API-sleutel wordt uitsluitend verstuurd in de Authorization-header van POST /api/v1/auth/token. Plaats de sleutel niet in JSON, een URL of queryparameters.
- Authorization: Bearer
- Gebruik het teruggegeven token voor resourceverzoeken en vernieuw het volgens expires_at; expires_in wordt uitgedrukt in seconden.
Waarom eerst een token ophalen?
Met je API-sleutel haal je een token op. Het token is 15 minuten geldig en kan voor meerdere verzoeken worden gebruikt. Stuur naar resources alleen het token in de header Authorization: Bearer.
Gewone verzoeken bevatten je API-sleutel niet. Een uitgelekt token geeft hoogstens toegang tot het verloopt. Met een gestolen API-sleutel kunnen mogelijk nog steeds nieuwe tokens worden opgehaald.
Hoelang is een token geldig?
- expires_in
- 900 seconden, dus 15 minuten vanaf uitgifte. Verzoeken verlengen de geldigheid niet.
- expires_at
- Vervaltijd in UTC. Actuele toegangsbeperkingen kunnen het token eerder blokkeren.
Wanneer haal je een nieuw token op?
Gebruik hetzelfde token voor meerdere verzoeken en haal vóór expires_at een nieuw token op. Dit hoeft niet vóór elke bewerking. Gebruik je API-sleutel om het nieuwe token op te halen.
Toegang geweigerd en opnieuw proberen
- 401
- 401 betekent niet altijd dat het token verlopen is. Is het verlopen, haal dan een nieuw token op en herhaal het leesverzoek hoogstens één keer. Geeft het ophalen van een token 401, controleer dan de sleutel en stop automatische pogingen.
- 403
- Controleer bij 403 de rechten, IP-beperkingen en het abonnement. Een nieuw token herstelt ingetrokken toegang niet.
IP-beperkingen
- Een toegangstoken omzeilt geen actuele sleutelrechten, abonnementsrechten, intrekkingen of IP-beperkingen.
- Beperk een sleutel waar passend tot de bronadressen van de integratie.
- Een beheerder kan deze lijst wijzigen; maximaal 32 adressen worden geaccepteerd.
Sleutelbeheer
- Het beheren van API-sleutels staat los van de resourcerechten van een integratie.
- Alleen owner kan groepen de beheerrechten verlenen om sleutels te bekijken, aan te maken, te wijzigen of te verwijderen.
- Een bevoegd groepslid kan uitsluitend de handelingen uitvoeren die aan die groep zijn toegekend.
Verzoeklimieten
Engine ≥ 4.143.0. Elke tokenrespons bevat data.rate_limits uit het winkelbeleid op het moment van uitgifte. Alle sleutels delen deze budgetten; een nieuw token zet ze niet terug. Een abonnementswijziging kan gelden voordat het token verloopt.
- read_per_minute
- Leesverzoeken per minuut.
- write_per_minute
- Schrijfverzoeken per minuut; deze waarde verleent geen schrijfrechten.
- auth_per_minute
- Tokenverzoeken per minuut, inclusief mislukte authenticatiepogingen.