# Hoe maak ik een API-sleutel voor een integratie?

Open de openbare API in Mijn bedrijf, maak een sleutel met de benodigde rechten en kopieer deze meteen.

Openen in Kinmu: <https://my.kinmu.app/nl/dashboard/company#public-api>

## Op het web

1. ### Open je bedrijf

   Selecteer **Mijn bedrijf**.

   De bedrijfsinstellingen verschijnen.

2. ### Open de API

   Open bij **Extensies** het onderdeel voor de openbare API.

   De sleutellijst verschijnt.

3. ### Maak een sleutel

   Selecteer **API-sleutel aanmaken**.

   Het formulier opent.

4. ### Geef een naam op

   Vul een herkenbare naam in. Kies zo mogelijk productie of sandbox met testgegevens.

   Naam en omgeving zijn ingesteld.

5. ### Kies de vervaldatum

   Kies een geldigheidsduur of geen vervaldatum.

   De gekozen geldigheid verschijnt.

6. ### Kies rechten

   Selecteer alleen de rechten die de integratie nodig heeft.

   De gekozen rechten staan in het formulier.

7. ### Genereer de sleutel

   Selecteer **Sleutel aanmaken**.

   De volledige sleutel wordt eenmalig getoond.

8. ### Bewaar de sleutel

   Kopieer deze naar een veilige plek en sluit het venster.

   In de lijst is de sleutel afgeschermd.

## Als je de optie niet ziet

- Open op je telefoon eerst het menu met de menuknop.
- Je hebt de openbare-API-uitbreiding en de rol **Globale beheerder** of **Manager** nodig. Kies minstens één recht. Bij het maximum aantal actieve sleutels moet je er eerst één intrekken.

## Veelgestelde vragen

### Kan ik een verloren sleutel terughalen?

Nee. Roteer de sleutel of maak een nieuwe. Na rotatie werkt de oude direct niet meer.

### Hoe blokkeer ik een integratie?

Trek de sleutel in. Dit werkt direct en is onomkeerbaar.

## Resultaat

De integratie kan de sleutel gebruiken met Authorization: Bearer. Technische documentatie staat op [docs.kinmu.app](https://docs.kinmu.app/).