# API-toegang gebruiken

> Maak persoonlijke toegangstokens voor scripts en MCP-clients en stuur met webhooks gebeurtenissen uit je Livespace naar je eigen systemen.

In Instellingen › **API-toegang** maak je persoonlijke toegangstokens, zodat een script of een MCP-client Dvina namens jou kan gebruiken. Beheerders kunnen daar ook webhooks toevoegen om gebeurtenissen uit de Livespace naar hun eigen systemen te sturen.

API-toegang is inbegrepen bij het Enterprise-abonnement. Elk lid kan eigen tokens maken; alleen eigenaren en beheerders zien **Webhooks**.

## Een token maken

1. Open Instellingen en kies **API-toegang**.
2. Kies onder **Persoonlijke toegangstokens** de optie **Token maken**.
3. Voer een **Naam** in, zodat je later weet waarvoor het token wordt gebruikt.
4. Kies de **Toegang**: **Alleen lezen** of **Lezen en schrijven**.
5. Kies wanneer het token **Verloopt**: **Over 30 dagen**, **Over 90 dagen**, **Over 365 dagen** of **Verloopt nooit**.
6. Kies **Token maken**.
7. Kopieer het token onder **Kopieer je token** en bewaar het op een veilige plek. Je krijgt het alleen nu te zien.

Een token werkt namens jou, in de Livespace waarin je het hebt gemaakt, met de rol die je daar op dit moment hebt. Een token met **Alleen lezen** kan gegevens lezen, maar niets toevoegen of wijzigen.

Als je een token met een MCP-client wilt gebruiken, zie [Verbinding maken met een API-sleutel in plaats van OAuth](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## Een token controleren, roteren of intrekken

Je tokens staan onder **Persoonlijke toegangstokens**, met hun toegangsniveau. Kies een token om te zien waarmee het **Begint**, welke **Toegang** het heeft, wanneer het **Laatst gebruikt** is en wanneer het **Verloopt**.

- **Om een token te vervangen**, kies je **Roteren…** en vervolgens **Roteren** om te bevestigen. Een nieuw token vervangt het oude, dat meteen niet meer werkt. Kopieer het nieuwe token onder **Kopieer je token**.
- **Om een token buiten gebruik te stellen**, kies je **Intrekken…** en vervolgens **Intrekken** om te bevestigen. Alles wat het token gebruikt, werkt meteen niet meer.

Het maken, roteren en intrekken van een token wordt vastgelegd in het [auditlogboek](/docs/teams/audit-log).

## Een webhook toevoegen

Een webhook stuurt gebeurtenissen uit de Livespace naar een adres dat je zelf kiest. Dit zijn dezelfde registraties als in het [auditlogboek](/docs/teams/audit-log).

1. Kies in Instellingen › **API-toegang**, onder **Webhooks**, de optie **Webhook toevoegen**.
2. Voer een **Naam** en de **URL** in. Gebruik een openbaar toegankelijke HTTPS-URL.
3. Laat **Gebeurtenissen** leeg om alle gebeurtenissen te ontvangen, of geef acties en onderdelen op, zoals `member.added` of `sharing.*`.
4. Kies **Toevoegen**.
5. Kopieer de geheime sleutel onder **Kopieer de geheime ondertekeningssleutel**. Je krijgt deze alleen nu te zien.

Als Dvina de melding **Dit adres is niet bereikbaar vanuit Dvina** toont, gebruik dan een openbaar toegankelijke HTTPS-URL.

### De handtekening van elk verzoek controleren

Dvina stuurt gebeurtenissen in batches als JSON en ondertekent elk verzoek. Gebruik de geheime ondertekeningssleutel om te controleren of een verzoek van Dvina afkomstig is:

- Elk verzoek heeft een `X-Dvina-Signature`-header zoals `t=<timestamp>,v1=<signature>`.
- De handtekening is een HMAC-SHA256 in hexadecimale notatie van de tijdstempel, een punt en de hoofdtekst van het verzoek, gemaakt met je geheime ondertekeningssleutel.
- Bereken de handtekening zelf en vergelijk deze. Weiger een verzoek als de handtekening niet overeenkomt of de tijdstempel te oud is.

## Een webhook bekijken of wijzigen

Je webhooks staan onder **Webhooks** met hun status: **Aan**, **Gepauzeerd** of **Mislukt**. Kies een webhook om de details te bekijken.

- **Om de webhook te wijzigen**, pas je de **Naam**, **URL** of **Gebeurtenissen** aan en kies je **Bewaar**.
- **Om de webhook te pauzeren**, schakel je **Gebeurtenissen verzenden** uit. Schakel dit weer in om opnieuw gebeurtenissen te verzenden.
- **Om te zien hoe de webhook werkt**, bekijk je de **Status** en hoeveel gebeurtenissen zijn **Verzonden**. Bij een mislukte webhook wordt de **Laatste fout** weergegeven. Dvina blijft het proberen en legt de fout vast in het auditlogboek.
- **Om het geheim te wijzigen**, kies je **Nieuw ondertekeningsgeheim…** en bevestig je je keuze. Verzoeken worden meteen met het nieuwe geheim ondertekend, dus werk de ontvanger direct bij.
- **Om de webhook te verwijderen**, kies je **Verwijder…** en vervolgens **Verwijder** om te bevestigen. Er wordt niets meer naar deze webhook verzonden.

## Gerelateerd

- [Dvina vanuit andere apps gebruiken met MCP](/docs/dvina-mcp/overview)
- [Het auditlogboek gebruiken](/docs/teams/audit-log)
- [Overzicht van teams](/docs/teams/overview)