> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authenticatie

> Maak een API-sleutel aan en authenticeer je verzoeken.

> [!NOTE]
>
> De GetQR API is in bèta en beschikbaar voor geselecteerde workspaces. Details kunnen nog veranderen vóór de algemene release.

De GetQR API authenticeert elk verzoek met de API-sleutel van je account. Elke gebruiker heeft één sleutel, en die handelt namens jou in één workspace.

## Voordat je begint

* Je bent de Admin van de workspace of een Editor. Viewers kunnen geen API-sleutel aanmaken of gebruiken.
* De Admin van de workspace heeft een actief abonnement.

## Je API-sleutel aanmaken

**1. Open je accountinstellingen**

Open je accountinstellingen en ga naar **API**.

**2. Genereer de sleutel**

Klik op **Generate API key**.

**3. Kopieer de sleutel**

Toon de sleutel en kopieer hem. Sleutels beginnen met `sk_live_`.

Je kunt de sleutel op elk moment opnieuw tonen en kopiëren. De instellingen laten ook zien wanneer de sleutel is aangemaakt en wanneer hij voor het laatst is gebruikt.

## Verzoeken authenticeren

Stuur de sleutel als Bearer-token mee in de `Authorization`-header van elk verzoek:

```bash theme={null}
curl "https://getqr.com/api/v1/qrs" \
  -H "Authorization: Bearer sk_live_..."
```

| Probleem | Antwoord |
| - | - |
| Geen `Authorization`-header | `401 unauthorized`: "Missing Authorization header." |
| De header begint niet met `Bearer ` | `400 bad_request`: "Misconfigured authorization header. Did you forget to add 'Bearer '?" |
| Onbekende of opnieuw gegenereerde sleutel | `401 unauthorized`: "Unauthorized: Invalid API key." |
| Je rol is Viewer | `403 forbidden`: "API access is not available for this role." |
| Het abonnement van de Admin van de workspace is niet actief | `403 forbidden`: "Access denied: This account does not have an active subscription." |
| De API is niet ingeschakeld voor je workspace | `404 not_found`: "This endpoint is not available." |

De [statuscontrole](https://docs.getqr.com/nl/api/endpoints/health.md) is het enige endpoint dat zonder sleutel werkt.

## Toegang en rollen

* **Rollen.** Alleen de Admin van de workspace en Editors kunnen een API-sleutel aanmaken en gebruiken. Viewers niet.
* **Workspace.** Elke sleutel hoort bij één workspace, en elk verzoek wordt in die workspace uitgevoerd. Je hoeft geen workspace-ID mee te geven.
* **Live controles.** Bij elk verzoek wordt de toegang gecontroleerd op basis van je huidige rol en het abonnement van de Admin van de workspace. Je eigen abonnement telt niet mee. Wordt je rol gewijzigd in Viewer of loopt het abonnement van de Admin af, dan geven verzoeken `403` terug tot de toegang is hersteld. Je hebt geen nieuwe sleutel nodig.
* **Verwijdering.** Word je uit de workspace verwijderd, dan wordt je API-sleutel verwijderd. Word je opnieuw toegevoegd, genereer dan een nieuwe sleutel.

## Je sleutel opnieuw genereren

Genereer de sleutel opnieuw als hij is uitgelekt of als iemand er toegang toe heeft gekregen die dat niet hoort te hebben.

> [!WARNING]
>
> Je huidige sleutel werkt meteen niet meer. Elke app of integratie die hem gebruikt, werkt pas weer als je de nieuwe sleutel invult.

**1. Klik op Regenerate**

Ga in je accountinstellingen naar **API** en klik op **Regenerate**.

**2. Bevestig**

Klik op **Regenerate key**.

**3. Werk je apps bij**

Kopieer de nieuwe sleutel en vervang de oude overal waar je hem gebruikt.

## Je sleutel veilig bewaren

Behandel de sleutel als een wachtwoord: iedereen die hem heeft, kan QR-codes in je workspace maken, wijzigen en verwijderen.

* Bewaar hem in een omgevingsvariabele of een secrets manager, niet in de broncode.
* Roep de API alleen aan vanaf je server. Zet de sleutel nooit in een website, mobiele app of iets anders dat gebruikers kunnen inspecteren.
* Deel hem alleen met developers die hem nodig hebben.
* Genereer hem opnieuw zodra je vermoedt dat hij is uitgelekt.

## Veelvoorkomende problemen

> [accordion] Ik krijg 401 met een sleutel die eerder werkte
>
> De sleutel is opnieuw gegenereerd, of je bent uit de workspace verwijderd en de sleutel is verwijderd. Kopieer de huidige sleutel uit je accountinstellingen of genereer een nieuwe.

> [accordion] Ik krijg 403 bij elk verzoek
>
> Controleer of je rol Admin of Editor is en of het abonnement van de Admin van de workspace actief is. De sleutel werkt weer zodra de toegang is hersteld.

> [accordion] Ik krijg 404 "This endpoint is not available."
>
> De API is in bèta en nog niet ingeschakeld voor je workspace.

> [accordion] Ik zie de API-instellingen niet
>
> Ze verschijnen alleen voor de Admin van de workspace en Editors, en alleen in workspaces waar de API is ingeschakeld.

## Volgende stappen

> [card] [Introductie van de API](https://docs.getqr.com/nl/api/introduction.md)

> [card] [Fouten](https://docs.getqr.com/nl/api/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.