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

# Démarrage rapide de l'API REST

> Créez un jeton d'API et envoyez votre premier appel à l'API publique de Zippendo depuis votre propre système.

L'API REST permet à vos propres systèmes de travailler directement avec Zippendo : votre boutique en ligne, votre ERP ou votre système d'entrepôt peuvent créer des expéditions, lire des commandes et récupérer des étiquettes sans que personne n'ouvre l'application. Chaque endpoint public figure dans l'onglet Référence de l'API, avec un playground pour essayer des requêtes.

## 1. Créer un jeton d'API

<Steps>
  <Step title="Ouvrir les paramètres de l'API">
    Dans [app.zippendo.com](https://app.zippendo.com), ouvrez le menu de l'organisation en bas de la barre latérale, cliquez sur **Gérer**, puis sur **Paramètres de l'API**.
  </Step>

  <Step title="Créer un jeton">
    Cliquez sur **Ajouter un jeton d'API**, donnez-lui un nom (par exemple `Production WMS`), cochez les **Autorisations** nécessaires, puis cliquez sur **Créer le jeton**. Copiez le jeton immédiatement : il ne s'affiche qu'une seule fois.
  </Step>

  <Step title="Le conserver en lieu sûr">
    Les jetons d'API commencent par `zipp_`. Traitez-les comme des mots de passe : conservez-les dans des variables d'environnement, jamais dans le contrôle de version.
  </Step>
</Steps>

Voir [Paramètres de l'API](/docs/fr/settings/api-settings) pour les autorisations, l'expiration, la restriction à une marque et la suppression des jetons.

## 2. Trouver l'ID de votre organisation

Chaque endpoint attend l'ID de votre organisation (`orgId`) dans le chemin. Demandez à Zippendo à quelle organisation appartient votre jeton :

```bash theme={null}
curl -X POST https://api.zippendo.com/api-tokens/verify \
  -H "Content-Type: application/json" \
  -d '{ "token": "zipp_YOUR_TOKEN" }'
```

La réponse contient `orgId`, ainsi que les `scopes` et `expiresAt` du jeton.

## 3. Envoyer votre première requête

Envoyez le jeton comme identifiant Bearer à 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"
```

Remplacez `{orgId}` par l'ID obtenu à l'étape 2. Le jeton doit avoir l'autorisation `read:shipments` pour cet appel.

<Warning>
  Ne placez jamais de jetons d'API dans du code exécuté dans un navigateur ou une application mobile. Appelez Zippendo depuis votre backend.
</Warning>

<Tip>
  Vous préférez un client typé ? Des **[SDK](/docs/fr/sdks/overview)** gratuits pour TypeScript, Python, PHP, Go et Ruby couvrent chaque endpoint, ce qui vous évite le HTTP brut.
</Tip>

Chaque formule dispose d'un quota de requêtes par minute. Voir [Limites de débit](/docs/api-reference/rate-limits).

## 4. Explorer les endpoints

L'API publique couvre :

| Domaine | Usage typique |
| - | - |
| Expéditions | Créer, envoyer, scinder et suivre des expéditions ; récupérer des étiquettes et des documents |
| Commandes | Créer des commandes et lire les commandes importées par vos canaux de vente |
| Canaux de vente | Gérer des [canaux personnalisés](/docs/fr/order-channels/custom-channels) pour votre propre boutique en ligne ou ERP |
| Transporteurs | Connecter des transporteurs, lister leurs offres et rechercher des points relais |
| Devis d'expédition | Prix issus de vos règles d'expédition pour un panier en caisse |
| Règles d'expédition | Lire et gérer les règles d'expédition |
| Webhooks | Être notifié lorsque les expéditions, les commandes et le suivi changent |
| Adresses | Gérer les adresses de l'expéditeur, d'enlèvement et de retour |

Ouvrez la [référence de l'API](/docs/api-reference/overview) pour parcourir les chemins et les corps de requête, et pour essayer des requêtes dans le playground.

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Démarrage rapide des webhooks" icon="webhook" href="/docs/fr/quickstarts/webhooks">
    Envoyez des événements à votre serveur lorsque les données changent.
  </Card>

  <Card title="Devis d'expédition" icon="calculator" href="/docs/fr/quickstarts/shipping-quotes">
    Affichez les prix d'expédition d'un panier en caisse.
  </Card>

  <Card title="Serveur MCP" icon="bot" href="/docs/fr/mcp/overview">
    Laissez Claude, Cursor ou ChatGPT travailler dans Zippendo pour vous.
  </Card>

  <Card title="Canaux personnalisés" icon="plug" href="/docs/fr/order-channels/custom-channels">
    Envoyez à Zippendo les commandes de votre propre boutique en ligne ou ERP.
  </Card>
</CardGroup>


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