> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.laposta.org/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.laposta.org/_mcp/server.

# Hoe werkt authenticatie met je API-sleutel?

> De API gebruikt basic auth, met je sleutel als gebruikersnaam en een leeg wachtwoord.

Voor elke aanroep over https heb je een API-sleutel nodig. De sleutel bepaalt op welk account je werkt: er is geen aparte gebruikersnaam en geen token dat verloopt.

## Je sleutel meesturen

Authenticatie gaat via basic auth. Je vult je sleutel in als gebruikersnaam en laat het wachtwoord leeg. In curl zet je een dubbele punt achter de sleutel, anders vraagt curl alsnog om een wachtwoord.

Hoe dat werkt met de knop ‘Try it’ in deze documentatie, lees je bij [API uitproberen met Try it](/api-uitproberen).

```bash
curl https://api.laposta.nl/v2/list \
  -u JOUW_API_SLEUTEL:
```

Stuur je geen geldige sleutel mee, dan geeft de API een `401`-foutmelding terug:

```json
{
  "error": {
    "type": "invalid_request",
    "message": "No valid API-key provided"
  }
}
```

## Een sleutel aanmaken

Je kunt sleutels aanmaken in je account onder ‘Koppelingen’. Hoe je dat precies doet, wat je daarna nog van een sleutel kunt zien en hoeveel sleutels je kunt aanmaken, lees je bij [API-sleutel aanmaken](/hoe-kom-ik-aan-een-api-sleutel).

## Veilig omgaan met je sleutel

Een sleutel geeft toegang tot alle gegevens van het account, dus behandel hem als een wachtwoord.

> **Warning**
>
> Zet je sleutel nooit in code die in de browser draait, en ook niet in een openbare repository. Iemand die hem heeft, kan je relaties uitlezen en campagnes versturen.

Werk in plaats daarvan met een omgevingsvariabele of de secrets-opslag van je hostingpartij, en laat de aanroepen vanaf je eigen server lopen. Wil je iets testen, gebruik dan een aparte lijst in je eigen account. Doe dat zeker bij endpoints waarmee je gegevens aanmaakt of verwijdert. Een apart gratis testaccount aanmaken kan meestal niet: zie [Eén gratis account per organisatie](/er-is-al-een-gratis-account-voor-je-organisatie).

## Gerelateerde artikelen

#### [Een API-sleutel aanmaken](/hoe-kom-ik-aan-een-api-sleutel)

Je kunt je API-sleutels aanmaken en beheren op de pagina Koppelingen. Let op: een…

#### [Je eerste API-aanroep doen](/je-eerste-api-aanroep)

Doe je eerste API-aanroep en vraag je lijsten op, direct op deze site of vanaf je eigen…

#### [Wat zijn de limieten en foutmeldingen van de API?](/api-limieten-en-foutmeldingen)

Hoeveel aanvragen de API per minuut toestaat en welke status- en foutcodes je kunt…