Benodigde licentie
| Abonnement | Elk abonnement |
| Toegang | Admin |
Met een API-token handelt een ander systeem namens je account. Er een maken is makkelijk; ze goed beheren is het deel dat telt.
Een token maken
- Open het Beheercentrum, dan Apps en integraties, dan API's, dan API-tokens.
- Voeg een API-token toe.
- Geef het een omschrijving die zegt wat het gebruikt.
- Kopieer het token nu. Het wordt één keer getoond en daarna nooit meer.
- Sla op.
Schrijf een echte omschrijving
Het veld dat je later redt. Over twee jaar kijk je naar zes tokens en moet je weten welk je kunt intrekken. "Integratie" zegt je niets; "Financieel systeem, nachtelijke contractsynchronisatie, eigenaar: Bram" zegt je alles.
Eén token per integratie
Eén token over drie systemen delen betekent dat intrekken alle drie breekt, en dat je niet kunt zien welk systeem de aanroepen doet die je zorgen baren. Aparte tokens kosten niets.
Een token handelt als een gebruiker
Het draagt de rechten van het account waar het bij hoort, dus een token dat aan een admin hangt kan alles wat een admin kan. Hoeft de integratie alleen tickets te lezen, hang hem dan aan een account met de smallere rol in plaats van aan die van jou.
Een token is een wachtwoord. Niet in een gedeeld document, niet in een chatbericht, en niet in code die in versiebeheer terechtkomt. Het geeft toegang tot elk klantgesprek dat je hebt.
Ze verdwijnen, en de datums staan vast
API-tokens gaan eruit. Nieuwe accounts kunnen er al geen meer maken, en vanaf 27 oktober 2026 kan niemand er nog een aanmaken. Een token dat 30 dagen ongebruikt blijft, wordt automatisch gedeactiveerd, en een token dat 60 dagen gedeactiveerd staat, wordt verwijderd. Die opruiming loopt al sinds juli 2026, dus een token waar je een tijd niet naar hebt omgekeken kan al weg zijn; controleer dat voordat je aanneemt dat een koppeling nog is aangemeld. Op 30 april 2027 stopt elk resterend token met werken, ook voor webhook-authenticatie. OAuth-toegangstokens komen ervoor in de plaats.
Deze pagina heeft daarmee een korter doel dan voorheen. Hij is er om te houden wat je al hebt, en om voor de deur in oktober dichtgaat nog een laatste vervanger te maken. Wat je nu bouwt hoort op OAuth te draaien, en wat al op een token loopt heeft een datum in de agenda nodig, ruim voor april 2027.
Let op wat dat automatisch deactiveren in de praktijk betekent: een token dat je eens per kwartaal gebruikt, is weg op het moment dat je het weer nodig hebt.
Een gedeactiveerd token kan terug, zestig dagen lang
Deactiveren is niet verwijderen, en dat gat is je herstelmoment. Werkt een koppeling niet meer en staat het token op Deactivated, open dan het optiemenu ernaast en kies Reactivate. Het werkt meteen weer.
Je hebt zestig dagen vanaf de dag dat het is gedeactiveerd. Daarna is het token definitief verwijderd en valt er niets meer terug te halen, dus heeft de koppeling een nieuw token nodig, of beter: OAuth. Na 30 april 2027 kan er helemaal niets meer worden gereactiveerd.
De tokenlijst toont ook een kolom Deactivates on, en dat is het eerlijke antwoord op de vraag of iets volgende maand nog werkt. Zendesk mailt alle beheerders vóór een token deactiveert en nog eens vóór het wordt verwijderd, gebundeld in één bericht per dag, dus die zijn het waard om niet weg te filteren.
Trek in wat je niet herkent
Loop de lijst af en toe na. Een token waarvan niemand het doel kan uitleggen is ofwel ongebruikt, en dan kost intrekken niets, ofwel in gebruik door iets ongedocumenteerds, en dat moet je weten. Verwijderen zet een token blijvend uit, en een account houdt er hoogstens 256, dus kort houden heeft naast een beveiligingsreden ook een praktische.
Opmerkingen
0 opmerkingen
Artikel is gesloten voor opmerkingen.