Persoonlijke toegangstokens beheren en gebruiken

Met een persoonlijk toegangstoken (PAT) authenticeer je scripts en applicaties bij de Lumicast API als jezelf. Een API-sleutel hoort bij één werkomgeving en één rol. Een token werkt daarentegen met de rechten die je hebt in elke werkomgeving waar je lid van bent.

Gebruik je een token met een AI-assistent of MCP-client, dan worden de gegevens uit je werkomgeving die de opgevraagde tools teruggeven, gedeeld met die derde partij. Lees eerst de verklaring over gegevensdeling voor AI-connectors.

WARNING

Een token kan alles wat jouw account kan. Behandel het als een wachtwoord: deel het nooit, en kies het kleinste bereik en de kortste geldigheid waarmee je nog uit de voeten kunt.

Een token aanmaken

1. Klik op je naam onderaan in de navigatie.
2. Kies Toegangstokens.
3. Klik op Token aanmaken.
4. Vul een Tokennaam in en kies:
   • Bereik: Volledige toegang (alles wat jij kunt, in elke werkomgeving waar je lid van bent) of Alleen-lezen (kan gegevens lezen, maar nooit wijzigen).
   • Vervaldatum: 30, 60 of 90 dagen, of verloopt nooit.
5. Klik op Aanmaken. Kopieer de waarde van het token die je te zien krijgt. Om veiligheidsredenen wordt die maar één keer getoond en kun je die later niet meer opvragen.

Elke tokenwaarde begint met lcp_.

Een token gebruiken

De basis-URL van de API is https://api.lumicast.com. Authenticeer je verzoeken met een Authorization-header:

Authorization: Bearer <JOUW_TOKEN>

In de documentatie van de Lumicast API vind je alle endpoints.

INFO

Met een token met bereik Alleen-lezen kun je alleen leesverzoeken doen. Elk verzoek dat gegevens aanmaakt, wijzigt of verwijdert, wordt geweigerd.

Een token roteren

Bij roteren krijgt het token een nieuwe waarde. Naam, bereik en vervaldatum blijven hetzelfde. De oude waarde werkt direct niet meer, dus werk alles wat het token gebruikt bij met de nieuwe waarde. Gebruik de actie Roteren naast een token in de lijst en kopieer daarna de nieuwe waarde (ook die wordt maar één keer getoond). Een verlopen token kun je niet roteren: maak dan een nieuw token aan.

Een token intrekken

Gebruik de actie Verwijderen naast een token om het in te trekken. Alles wat dat token nog gebruikt, verliest direct toegang.