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

# Créer un jeton d'API

> Créez un jeton d'API dans Paramètres → Paramètres de l'API pour que vos propres systèmes puissent se connecter à Zippendo - nom, expiration, autorisations, copie unique du jeton et suppression.

Un **jeton d'API** permet à vos propres systèmes, ou à un développeur qui travaille pour vous, de se connecter à Zippendo : créer des expéditions, lire des commandes, enregistrer des webhooks et tout le reste décrit dans la [référence de l'API](/docs/api-reference/overview). Vous créez les jetons sous **Paramètres de l'API**. Zippendo n'affiche le jeton complet qu'une seule fois, juste après sa création.

Tour des paramètres : [Paramètres, équipe et marques](/docs/fr/tutorials/settings-team-brands). Première requête : [Démarrage rapide de l'API REST](/docs/fr/quickstarts/rest-api). Frais de livraison en caisse : [Obtenir un devis d'expédition](/docs/fr/how-to/shipping-quotes).

<Info>
  Toutes les formules incluent des jetons d'API : Free jusqu'à 2, Standard 5, Growth 10, Pro et Enterprise illimité. Une fois la limite atteinte, la création d'un jeton échoue avec **Vous avez atteint la limite de votre formule. Changez de formule ou supprimez un élément que vous n'utilisez plus.** Supprimez un jeton que vous n'utilisez plus, ou changez de formule.
</Info>

## Où le trouver

Ouvrez le menu de l'organisation en bas de la barre latérale, cliquez sur **Gérer**, puis sur l'onglet **Paramètres de l'API**. Le bouton pour créer un jeton est **Ajouter un jeton d'API**, en haut à droite.

<Frame caption="Jetons d'API : nom, début de chaque jeton, autorisations et dernière utilisation">
  <img src="https://mintcdn.com/zippendo/y4CnODj6e9MAPx31/images/fr/how-to/create-an-api-token/01-api-settings-light.png?fit=max&auto=format&n=y4CnODj6e9MAPx31&q=85&s=b9bcb165ebf46e265e282c8dbda430f1" alt="Onglet Paramètres de l'API avec la liste des jetons d'API et Ajouter un jeton d'API dans l'en-tête" className="block dark:hidden" width="2880" height="1800" data-path="images/fr/how-to/create-an-api-token/01-api-settings-light.png" />

  <img src="https://mintcdn.com/zippendo/y4CnODj6e9MAPx31/images/fr/how-to/create-an-api-token/01-api-settings-dark.png?fit=max&auto=format&n=y4CnODj6e9MAPx31&q=85&s=ecc0641601ab118c3cfc3abdf6e224bc" alt="Onglet Paramètres de l'API avec la liste des jetons d'API et Ajouter un jeton d'API dans l'en-tête" className="hidden dark:block" width="2880" height="1800" data-path="images/fr/how-to/create-an-api-token/01-api-settings-dark.png" />
</Frame>

## La liste des jetons d'API

| Colonne | Ce qu'elle affiche |
| - | - |
| **Nom** | Le **Nom du jeton** que vous avez saisi. |
| **Jeton** | Les premiers caractères du jeton suivis de `...`. Le jeton complet n'est jamais affiché ici. |
| **Autorisations** | Jusqu'à trois autorisations, comme **Voir les expéditions** ; les autres sont réduites. **Aucune autorisation** si aucune n'a été choisie. |
| **Dernière utilisation** | Quand le jeton a été utilisé pour la dernière fois, ou **Jamais**. |
| **Créée par** | Le membre de l'équipe qui l'a créé. |
| **Expiration** | La date d'expiration, ou **Jamais**. Une date passée s'affiche en rouge. |
| **Créée le** | Quand il a été créé. |

La seule action possible sur un jeton dans la liste est de le **Supprimer**. Vous ne pouvez ni modifier ni renommer un jeton.

Sans jeton, la liste affiche **Aucun jeton d'API** et un bouton **Créer votre premier jeton**.

## Créer un jeton

<Steps>
  <Step title="Ouvrir la fenêtre">
    Cliquez sur **Ajouter un jeton d'API**, ou sur **Créer votre premier jeton** lorsque la liste est vide. La fenêtre **Créer un jeton d'API** s'ouvre.
  </Step>

  <Step title="Nommer le jeton">
    Renseignez **Nom du jeton \***, par exemple « Warehouse WMS ». Vous pouvez aussi définir **Expire dans (jours)** et **Limiter à une marque**.
  </Step>

  <Step title="Choisir les autorisations">
    Cochez ce que le jeton peut faire, ou cliquez sur **Tout sélectionner**.
  </Step>

  <Step title="Le créer">
    Cliquez sur **Créer le jeton**. Vous voyez **Jeton d'API créé**, et **Jeton d'API créé** s'ouvre avec le jeton complet.
  </Step>
</Steps>

<Frame caption="Créer un jeton d'API : nom, expiration facultative, puis les autorisations">
  <img src="https://mintcdn.com/zippendo/y4CnODj6e9MAPx31/images/fr/how-to/create-an-api-token/02-create-modal-light.png?fit=max&auto=format&n=y4CnODj6e9MAPx31&q=85&s=e46976d41356f0aa5baeb3fe99dfc0b5" alt="Fenêtre Créer un jeton d'API avec Nom du jeton, Expire dans (jours) et les cases d'autorisations" className="block dark:hidden" width="2880" height="2800" data-path="images/fr/how-to/create-an-api-token/02-create-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/y4CnODj6e9MAPx31/images/fr/how-to/create-an-api-token/02-create-modal-dark.png?fit=max&auto=format&n=y4CnODj6e9MAPx31&q=85&s=bfad7a763eba39a7c8ed5d79c55e1209" alt="Fenêtre Créer un jeton d'API avec Nom du jeton, Expire dans (jours) et les cases d'autorisations" className="hidden dark:block" width="2880" height="2800" data-path="images/fr/how-to/create-an-api-token/02-create-modal-dark.png" />
</Frame>

| Champ | Obligatoire | Que saisir |
| - | - | - |
| **Nom du jeton \*** | Oui | Un nom qui vous indique où le jeton est utilisé, comme « Production API » ou « Webhook Service ». Jusqu'à 100 caractères. |
| **Limiter à une marque** | Non | Affiché uniquement si votre organisation a des [marques](/docs/fr/how-to/create-a-brand). Choisissez une marque et **Les applications et systèmes qui utilisent ce jeton ne peuvent voir et modifier que les données de cette marque.** La valeur par défaut est **Aucune marque (toute l'organisation)**. Vous ne pourrez pas la changer plus tard. |
| **Expire dans (jours)** | Non | Un nombre de 1 à 365. Le jeton cesse de fonctionner après ce nombre de jours. Laissez vide pour un jeton qui n'expire jamais. |
| **Autorisations \*** | Oui, au moins une | Ce que le jeton peut lire et modifier. Voir la liste ci-dessous. |

**Créer le jeton** reste grisé tant que le jeton n'a pas de nom et au moins une autorisation.

### Autorisations

Chaque domaine a une autorisation de **Lecture** (**Consulter les informations**) et une autorisation d'**Écriture** (**Créer, modifier et supprimer**). Une autorisation d'**Écriture** inclut la **Lecture** du même domaine.

<Frame caption="Toutes les autorisations, avec Tout sélectionner activé">
  <img src="https://mintcdn.com/zippendo/y4CnODj6e9MAPx31/images/fr/how-to/create-an-api-token/03-permissions-light.png?fit=max&auto=format&n=y4CnODj6e9MAPx31&q=85&s=540c48d695f34d22c3c3327b4702b8bc" alt="Autorisations de Créer un jeton d'API avec cases Lecture et Écriture, dont Tout voir et Tout modifier" className="block dark:hidden" width="2880" height="2800" data-path="images/fr/how-to/create-an-api-token/03-permissions-light.png" />

  <img src="https://mintcdn.com/zippendo/y4CnODj6e9MAPx31/images/fr/how-to/create-an-api-token/03-permissions-dark.png?fit=max&auto=format&n=y4CnODj6e9MAPx31&q=85&s=661843580fc05a6e9b3fa4bcfd7f86b0" alt="Autorisations de Créer un jeton d'API avec cases Lecture et Écriture, dont Tout voir et Tout modifier" className="hidden dark:block" width="2880" height="2800" data-path="images/fr/how-to/create-an-api-token/03-permissions-dark.png" />
</Frame>

| Autorisation | Couvre |
| - | - |
| **Voir les expéditions** / **Modifier les expéditions** | Expéditions |
| **Voir les règles d'expédition** / **Modifier les règles d'expédition** | Règles d'expédition, et [devis d'expédition](/docs/fr/how-to/shipping-quotes) |
| **Voir les transporteurs** / **Modifier les transporteurs** | Transporteurs connectés |
| **Voir les adresses** / **Modifier les adresses** | Adresses de l'expéditeur |
| **Voir l'organisation** / **Modifier l'organisation** | Les informations de votre organisation |
| **Voir les membres de l'équipe** / **Modifier les membres de l'équipe** | Membres de l'équipe |
| **Voir les jetons d'API** / **Modifier les jetons d'API** | Autres jetons d'API |
| **Tout voir** / **Tout modifier** | Tout ce qui précède sauf les jetons d'API, plus les commandes, les canaux de vente, les imprimantes, les webhooks, les automatisations, les intégrations et les rôles |

Les commandes, les canaux de vente, les imprimantes, les webhooks, les automatisations et les intégrations n'ont pas d'autorisation propre : un jeton qui en a besoin doit avoir **Tout voir** ou **Tout modifier**. Aucune des deux n'inclut les jetons d'API : cochez donc aussi **Modifier les jetons d'API** si le jeton doit créer ou supprimer d'autres jetons. Les mêmes autorisations sont utilisées pour les [rôles personnalisés](/docs/fr/how-to/roles-and-permissions).

## Copier le jeton (une seule fois)

**Jeton d'API créé** affiche le jeton complet, qui commence par `zipp_`. La fenêtre avertit : **Copiez bien ce jeton. Vous ne pourrez plus le voir après avoir fermé cette fenêtre.**

<Frame caption="Jeton d'API créé : copiez le jeton avant de fermer la fenêtre">
  <img src="https://mintcdn.com/zippendo/y4CnODj6e9MAPx31/images/fr/how-to/create-an-api-token/04-token-secret-light.png?fit=max&auto=format&n=y4CnODj6e9MAPx31&q=85&s=10e9331139fca53022dc51304a71d4ef" alt="Fenêtre Jeton d'API créé avec le jeton, un bouton Copier et un avertissement Important" className="block dark:hidden" width="2880" height="1800" data-path="images/fr/how-to/create-an-api-token/04-token-secret-light.png" />

  <img src="https://mintcdn.com/zippendo/y4CnODj6e9MAPx31/images/fr/how-to/create-an-api-token/04-token-secret-dark.png?fit=max&auto=format&n=y4CnODj6e9MAPx31&q=85&s=02e1de349c09bf7287ae93f61dac234c" alt="Fenêtre Jeton d'API créé avec le jeton, un bouton Copier et un avertissement Important" className="hidden dark:block" width="2880" height="1800" data-path="images/fr/how-to/create-an-api-token/04-token-secret-dark.png" />
</Frame>

Cliquez sur **Copier**. Vous voyez **Jeton copié dans le presse-papiers**. Si vous voyez **Impossible de copier le jeton**, sélectionnez le jeton et copiez-le à la main. Fermez ensuite la fenêtre. Si vous perdez le jeton, supprimez-le et créez-en un nouveau.

<Warning>
  Traitez le jeton comme un mot de passe. Ne le mettez pas dans un code que d'autres peuvent voir ni dans une page web. S'il fuite, supprimez-le (voir « Supprimer un jeton » ci-dessous) et créez-en un nouveau. Requêtes qui échouent : [Erreurs d'authentification par jeton d'API](/docs/fr/knowledge-base/api-token-authentication-errors).
</Warning>

## Utiliser le jeton

Votre développeur envoie le jeton avec chaque requête :

```bash theme={null}
curl https://api.zippendo.com/orgs/{orgId}/shipments \
  -H "Authorization: Bearer zipp_YOUR_TOKEN" \
  -H "Content-Type: application/json"
```

`{orgId}` est l'ID de votre organisation, pas le nom affiché dans la barre d'adresse de l'application. Un développeur peut le lister avec les requêtes Orgs de la [référence de l'API](/docs/api-reference/overview), où chaque requête et chaque réponse sont décrites. Clients prêts à l'emploi : [SDK](/docs/fr/sdks/overview). Limites : [Limites de débit](/docs/api-reference/rate-limits).

Un jeton sans marque peut cibler une marque pour une seule requête avec l'en-tête `X-Zippendo-Brand`. Un jeton créé avec **Limiter à une marque** reste toujours dans sa marque. Voir [Marques](/docs/fr/settings/brands).

## Supprimer un jeton

Cliquez sur **Supprimer** sur la ligne du jeton. **Supprimer le jeton d'API** vous demande de saisir le nom du jeton en majuscules, par exemple `WAREHOUSE WMS`, puis de cliquer sur **Supprimer**. Vous voyez **Jeton d'API supprimé**. Tout système qui utilise le jeton ne peut plus se connecter. La suppression est irréversible, et il n'existe aucun moyen de mettre un jeton en pause à la place.

<Frame caption="Supprimer le jeton d'API : saisissez le nom en majuscules pour confirmer">
  <img src="https://mintcdn.com/zippendo/y4CnODj6e9MAPx31/images/fr/how-to/create-an-api-token/05-delete-token-light.png?fit=max&auto=format&n=y4CnODj6e9MAPx31&q=85&s=f6b501b6ad3fa51be7d389d38c23c6ef" alt="Fenêtre Supprimer le jeton d'API avec un champ pour saisir le nom à confirmer" className="block dark:hidden" width="2880" height="1800" data-path="images/fr/how-to/create-an-api-token/05-delete-token-light.png" />

  <img src="https://mintcdn.com/zippendo/y4CnODj6e9MAPx31/images/fr/how-to/create-an-api-token/05-delete-token-dark.png?fit=max&auto=format&n=y4CnODj6e9MAPx31&q=85&s=b01d5d391828de2cf32069ab308f780d" alt="Fenêtre Supprimer le jeton d'API avec un champ pour saisir le nom à confirmer" className="hidden dark:block" width="2880" height="1800" data-path="images/fr/how-to/create-an-api-token/05-delete-token-dark.png" />
</Frame>

## À lire aussi

* [Webhooks](/docs/fr/how-to/webhooks) : Zippendo prévient votre système lorsque quelque chose se produit, au lieu que votre système interroge Zippendo.
* [Connecter Slack, Klaviyo et d'autres applications](/docs/fr/how-to/connect-an-integration) : des connexions prêtes à l'emploi qui n'ont pas besoin de jeton d'API.
* [API de canal personnalisé](/docs/fr/how-to/custom-channel-api) : envoyez les commandes de votre propre boutique ou système dans Zippendo.
* [Obtenir un devis d'expédition](/docs/fr/how-to/shipping-quotes) : frais de livraison en caisse.
* [Authentification MCP](/docs/fr/mcp/authentication) : connectez un agent d'IA sans coller de jeton.


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