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

# Authenticatiefouten bij API-tokens

> Wat je doet als aanroepen van de Zippendo API met een API-token worden geweigerd met 401 Unauthorized, 403 Forbidden of 429 Too Many Requests.

Met een API-token kan je eigen systeem of het script van een ontwikkelaar met Zippendo werken. Je maakt tokens aan onder **Instellingen** → **API-instellingen** (open het organisatiemenu en klik op **Beheren**). Als een aanroep wordt geweigerd, zegt het antwoord waarom.

## Wat je ziet

* `401 Unauthorized` met `Invalid or expired token` of `Authentication required`.
* `403 Forbidden` met `Missing required scope` of **Je hebt geen toegang tot deze organisatie.**
* `429 Too Many Requests` met `API rate limit of … requests per minute reached.`
* De aanroep werkt in de Zippendo-app, maar mislukt vanuit je script of server.

## 401: het token wordt niet geaccepteerd

| Melding | Waarschijnlijke oorzaak | Wat je doet |
| - | - | - |
| `Authentication required` | Er is geen token meegestuurd | Stuur het token mee in de header `Authorization`, zoals hieronder getoond |
| `Invalid or expired token` | Het token is verkeerd getypt, afgekapt, verwijderd of verlopen | Controleer het token zoals hieronder beschreven. Maak bij twijfel een nieuw token aan |
| `Invalid token type` | Er is iets anders dan een API-token gestuurd, bijvoorbeeld een waarde uit de browser gekopieerd | Gebruik het token dat werd getoond toen je op **Token aanmaken** klikte |

Stuur het token zo mee, met het woord `Bearer` en één spatie ervoor:

```bash theme={null}
Authorization: Bearer zipp_YOUR_TOKEN
```

Controleer of:

1. Het token met `zipp_` begint en volledig is gekopieerd, zonder spaties of regeleinden aan het eind.
2. Het token nog bestaat onder **API-instellingen**. Een token verwijderen stopt het direct.
3. Het token niet is verlopen. De kolom **Verloopt** toont de datum. Een token dat zonder **Verloopt over (dagen)** is aangemaakt, verloopt nooit.

Zippendo toont een token maar één keer, in **API-token aangemaakt**. Als je het niet meer hebt, maak je met **API-token toevoegen** een nieuw token aan en verwijder je het oude. Zie [Een API-token aanmaken](/docs/nl/how-to/create-an-api-token).

## 403: het token mag dit niet doen

| Melding | Waarschijnlijke oorzaak | Wat je doet |
| - | - | - |
| `Missing required scope`, gevolgd door een rechtnaam zoals `write:shipments` | Het token is zonder dat recht aangemaakt | Maak een nieuw token aan en vink het recht aan onder **Rechten \***. De kolom **Rechten** toont wat elk token kan doen |
| **Je hebt geen toegang tot deze organisatie.** | De organisatie in het adres van de aanroep is niet die waartoe het token behoort | Gebruik de organisatie waarin het token is aangemaakt, of maak een token aan in de andere organisatie |
| **Deze functie zit niet in je huidige abonnement. Upgrade om hem te gebruiken.** | De functie die je aanriep is geen onderdeel van je abonnement | Zie [Facturatie en gebruik](/docs/nl/how-to/billing-and-usage) |

## 429: te veel aanroepen

Elk abonnement staat een aantal API-aanroepen per minuut toe:

| Abonnement | Aanroepen per minuut |
| - | - |
| Free | 10 |
| Standard | 60 |
| Growth | 200 |
| Pro | 1,000 |
| Enterprise | 100,000 |

Als je erboven komt, is het antwoord `API rate limit of … requests per minute reached. Please retry in … s.` De header `Retry-After` zegt hoeveel seconden je moet wachten. Wacht zo lang, probeer het dan opnieuw en spreid je aanroepen. Meer: [Limieten](/docs/api-reference/rate-limits).

## Je kunt geen nieuw token aanmaken

**Je hebt de limiet van je abonnement bereikt. Upgrade je abonnement of verwijder iets wat je niet meer gebruikt.** betekent dat het aantal API-tokens van je abonnement op is: 2 bij Free, 5 bij Standard, 10 bij Growth, en geen limiet bij Pro en Enterprise. Verwijder een token dat je niet meer gebruikt, of upgrade.

## Goede gewoonten

* Bewaar tokens op je server. Zet een token nooit op een webshoppagina of in andere code die in de browser van een klant draait.
* Geef elk systeem een eigen token, met alleen de rechten die het nodig heeft. Dan kun je er een verwijderen zonder de andere te stoppen.

Gerelateerd: [REST API-quickstart](/docs/nl/quickstarts/rest-api), [API-instellingen](/docs/nl/settings/api-settings), [API-overzicht](/docs/api-reference/overview).


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