> ## 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.

# Erreurs d'authentification par jeton d'API

> Que faire lorsque les appels à l'API Zippendo avec un jeton d'API sont rejetés avec 401 Unauthorized, 403 Forbidden ou 429 Too Many Requests.

Un jeton d'API permet à votre propre système ou au script d'un développeur de travailler avec Zippendo. Vous créez les jetons sous **Paramètres** → **Paramètres de l'API** (ouvrez le menu de l'organisation et cliquez sur **Gérer**). Si un appel est rejeté, la réponse en indique la raison.

## Ce que vous voyez

* `401 Unauthorized` avec `Invalid or expired token` ou `Authentication required`.
* `403 Forbidden` avec `Missing required scope` ou **Vous n'avez pas accès à cette organisation.**
* `429 Too Many Requests` avec `API rate limit of … requests per minute reached.`
* L'appel fonctionne dans l'application Zippendo, mais échoue depuis votre script ou votre serveur.

## 401 : le jeton n'est pas accepté

| Message | Cause probable | Que faire |
| - | - | - |
| `Authentication required` | Aucun jeton n'a été envoyé | Envoyez le jeton dans l'en-tête `Authorization`, comme indiqué ci-dessous |
| `Invalid or expired token` | Le jeton a été mal saisi, tronqué, supprimé ou a expiré | Vérifiez le jeton comme décrit ci-dessous. En cas de doute, créez-en un nouveau |
| `Invalid token type` | Autre chose qu'un jeton d'API a été envoyé, par exemple une valeur copiée depuis le navigateur | Utilisez le jeton affiché lorsque vous avez cliqué sur **Créer le jeton** |

Envoyez le jeton ainsi, avec le mot `Bearer` suivi d'un espace :

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

Vérifiez que :

1. Le jeton commence par `zipp_` et a été copié en entier, sans espace ni saut de ligne à la fin.
2. Le jeton existe toujours sous **Paramètres de l'API**. La suppression d'un jeton l'arrête immédiatement.
3. Le jeton n'a pas expiré. La colonne **Expiration** indique la date. Un jeton créé sans **Expire dans (jours)** n'expire jamais.

Zippendo n'affiche un jeton qu'une seule fois, dans **Jeton d'API créé**. Si vous ne l'avez plus, créez un nouveau jeton avec **Ajouter un jeton d'API** et supprimez l'ancien. Voir [Créer un jeton d'API](/docs/fr/how-to/create-an-api-token).

## 403 : le jeton n'est pas autorisé à faire cela

| Message | Cause probable | Que faire |
| - | - | - |
| `Missing required scope`, suivi d'un nom d'autorisation tel que `write:shipments` | Le jeton a été créé sans cette autorisation | Créez un nouveau jeton et cochez l'autorisation sous **Autorisations \***. La colonne **Autorisations** indique ce que peut faire chaque jeton |
| **Vous n'avez pas accès à cette organisation.** | L'organisation indiquée dans l'adresse de l'appel n'est pas celle à laquelle appartient le jeton | Utilisez l'organisation dans laquelle le jeton a été créé, ou créez un jeton dans l'autre organisation |
| **Cette fonctionnalité n'est pas incluse dans votre formule actuelle. Changez de formule pour l'utiliser.** | La fonctionnalité appelée ne fait pas partie de votre formule | Voir [Facturation et utilisation](/docs/fr/how-to/billing-and-usage) |

## 429 : trop d'appels

Chaque formule autorise un certain nombre d'appels d'API par minute :

| Formule | Appels par minute |
| - | - |
| Free | 10 |
| Standard | 60 |
| Growth | 200 |
| Pro | 1,000 |
| Enterprise | 100,000 |

Lorsque vous dépassez la limite, la réponse est `API rate limit of … requests per minute reached. Please retry in … s.` L'en-tête `Retry-After` indique combien de secondes attendre. Attendez ce délai, puis réessayez, et espacez vos appels. Plus d'informations : [Limites de débit](/docs/api-reference/rate-limits).

## Vous ne pouvez pas créer d'autre jeton

**Vous avez atteint la limite de votre formule. Changez de formule ou supprimez un élément que vous n'utilisez plus.** signifie que le nombre de jetons d'API de votre formule est atteint : 2 avec Free, 5 avec Standard, 10 avec Growth, et aucune limite avec Pro et Enterprise. Supprimez un jeton que vous n'utilisez plus, ou changez de formule.

## Bonnes habitudes

* Gardez les jetons sur votre serveur. Ne mettez jamais un jeton dans une page de boutique en ligne ni dans un autre code exécuté dans le navigateur d'un client.
* Donnez à chaque système son propre jeton, avec uniquement les autorisations dont il a besoin. Vous pourrez alors en supprimer un sans arrêter les autres.

À lire aussi : [Démarrage rapide de l'API REST](/docs/fr/quickstarts/rest-api), [Paramètres de l'API](/docs/fr/settings/api-settings), [Présentation de l'API](/docs/api-reference/overview).


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