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.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 :
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 :{orgId} par l’ID obtenu à l’étape 2. Le jeton doit avoir l’autorisation read:shipments pour cet appel.
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.