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

# Paramètres de l'API

> Créez et supprimez les jetons d'API que votre développeur utilise pour connecter vos propres systèmes à Zippendo.

**Paramètres de l'API** est l'endroit où vous créez des **jetons d'API**. Un jeton d'API permet à vos propres systèmes, ou à un développeur travaillant pour vous, de communiquer directement avec Zippendo : créer des expéditions, lire des commandes, ou connecter un système d'entrepôt ou de gestion interne.

## 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**. Vous voyez vos jetons et un bouton **Ajouter un jeton d'API**.

Toutes les formules incluent des jetons d'API : Free jusqu'à 2, Standard 5, Growth 10, Pro et Enterprise en nombre illimité.

## Créer un jeton d'API

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

  <Step title="Nommer le jeton">
    Saisissez un **Nom du jeton \***, comme « Intégration WMS » ou « Back-office », pour le reconnaître plus tard. Vous pouvez aussi définir **Expire dans (jours)** (jusqu'à 365) et, si votre organisation a des marques, **Limiter à une marque**.
  </Step>

  <Step title="Choisir les autorisations">
    Cochez les **Autorisations \*** dont le jeton a besoin, par exemple **Voir les expéditions** et **Modifier les expéditions**.
  </Step>

  <Step title="Créer et copier le jeton">
    Cliquez sur **Créer le jeton**. Le jeton complet s'affiche une seule fois, dans **Jeton d'API créé**. Cliquez sur **Copier** et conservez-le en lieu sûr : vous ne pourrez plus le voir après avoir fermé la fenêtre.
  </Step>
</Steps>

<Warning>
  Traitez un jeton d'API comme un mot de passe. Ne le partagez pas et ne le placez pas dans du code visible par d'autres. Si un jeton fuite, supprimez-le et créez-en un nouveau.
</Warning>

## Utiliser le jeton

Votre développeur envoie le jeton dans l'en-tête `Authorization` de chaque requête :

`Authorization: Bearer YOUR_TOKEN`

L'adresse à appeler et chaque requête figurent dans la [référence de l'API](/docs/api-reference/overview). Un jeton n'accède qu'aux données de votre propre organisation.

## Limiter un jeton à une marque

Si votre organisation utilise des [marques](/docs/fr/settings/brands), vous pouvez définir **Limiter à une marque** lors de la création d'un jeton. Chaque requête faite avec ce jeton ne peut alors lire et écrire que les données de cette marque. Vous ne pouvez pas modifier ni retirer la marque ensuite : créez donc un nouveau jeton si vous en avez besoin d'un autre.

Un jeton sans marque fonctionne pour toute l'organisation. Un développeur peut quand même cibler une seule marque pour une requête avec l'en-tête `X-Zippendo-Brand`, et définir une valeur par défaut pour les requêtes de liste avec l'en-tête `X-Zippendo-Brand-Scope` (`own`, `shared` ou `both`). Voir [Marques](/docs/fr/settings/brands) et la [référence de l'API](/docs/api-reference/overview).

## Supprimer un jeton

Pour empêcher un jeton de fonctionner, par exemple lorsqu'une intégration est retirée ou que le jeton a été exposé, cliquez sur **Supprimer** sur sa ligne dans **Paramètres de l'API**. Saisissez le nom du jeton en majuscules et confirmez. Tout système qui utilise ce jeton cesse immédiatement de fonctionner ; créez un nouveau jeton s'il doit continuer à fonctionner.

Chaque champ en détail : [Créer un jeton d'API](/docs/fr/how-to/create-an-api-token).


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