Skip to main content
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

1

Ouvrir les paramètres de l'API

Dans 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.
2

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

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.
Voir Paramètres de l’API 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 :
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 :
Remplacez {orgId} par l’ID obtenu à l’étape 2. Le jeton doit avoir l’autorisation read:shipments pour cet appel.
Ne placez jamais de jetons d’API dans du code exécuté dans un navigateur ou une application mobile. Appelez Zippendo depuis votre backend.
Vous préférez un client typé ? Des SDK gratuits pour TypeScript, Python, PHP, Go et Ruby couvrent chaque endpoint, ce qui vous évite le HTTP brut.
Chaque formule dispose d’un quota de requêtes par minute. Voir Limites de débit.

4. Explorer les endpoints

L’API publique couvre : Ouvrez la référence de l’API pour parcourir les chemins et les corps de requête, et pour essayer des requêtes dans le playground.

Étapes suivantes

Démarrage rapide des webhooks

Envoyez des événements à votre serveur lorsque les données changent.

Devis d'expédition

Affichez les prix d’expédition d’un panier en caisse.

Serveur MCP

Laissez Claude, Cursor ou ChatGPT travailler dans Zippendo pour vous.

Canaux personnalisés

Envoyez à Zippendo les commandes de votre propre boutique en ligne ou ERP.