API de livraison pour votre boutique en ligne au Maroc
Vos commandes arrivent chez Colivry dès qu'elles sont passées sur votre site, et chaque statut de livraison revient automatiquement chez vous. Plus de saisie à la main.
POST /api/v8/orders
{
"success": true,
"message": "1 commande(s) créée(s).",
"orders": ["CLV-2026110312000012345"]
}Ce que votre site peut faire avec l'API
L'API reprend les actions de votre espace client Colivry, pour que votre site ou votre CRM les fasse à votre place.
-
Créer les colis
Un colis à la fois ou plusieurs dans le même appel, avec le prix à encaisser à la livraison.
-
Demander le ramassage
Déclenchez une demande de ramassage pour les colis prêts, sans passer par l'espace client.
-
Suivre chaque colis
Statut actuel et historique complet, pour un colis ou pour toute une liste.
-
Recevoir les statuts
Avec un webhook, Colivry prévient votre site dès qu'un colis change de statut.
-
Corriger une commande
Changez l'adresse, le téléphone ou la remarque, ou annulez un colis encore au statut Nouveau.
-
Afficher les frais
Récupérez les villes, les secteurs et les frais de livraison pour les proposer à vos clients.
Démarrer en trois étapes
Il vous faut un compte client Colivry et au moins une boutique enregistrée.
-
Créez votre clé
Dans votre espace client, ouvrez Intégration API et générez une clé. Copiez la clé privée tout de suite : elle ne s'affiche qu'une fois.
-
Récupérez vos identifiants
Les villes et les boutiques s'indiquent par leur clé, à lire une fois avec
GET /api/v8/districtsetGET /api/v8/shops. -
Envoyez votre premier colis
Toutes les requêtes passent par
https://www.app.colivry.co.curl -X POST "https://www.app.colivry.co/api/v8/orders" \ -H "Authorization: Bearer CLE_PUBLIQUE:CLE_PRIVEE" \ -H "Content-Type: application/json" \ -H "User-Agent: MaBoutique/1.0" \ -d '{ "articleName": "T-shirt", "quantity": 1, "price": 250, "phone": "0600000000", "city": "CLE_VILLE", "shop": "CLE_BOUTIQUE", "address": "12 rue Exemple", "recipientName": "Nom du client" }'
Erreur 406 ? Envoyez un User-Agent au nom de votre application, comme MaBoutique/1.0. Le pare-feu du serveur refuse les valeurs par défaut de certains outils, dont python-requests et Go-http-client.
Les points d'accès
Chaque appel s'authentifie avec votre clé, et ne donne accès qu'aux données de votre compte.
| Méthode | Adresse | Rôle |
|---|---|---|
| GET | /api/v8/districts | Villes, secteurs et frais de livraison |
| GET | /api/v8/sectors | Secteurs, avec filtre possible par ville |
| GET | /api/v8/shops | Vos boutiques |
| GET | /api/v8/states | Statuts de livraison possibles |
| POST | /api/v8/orders | Créer un ou plusieurs colis |
| GET | /api/v8/orders | Lister vos colis |
| GET | /api/v8/orders/{code} | Détail et historique d'un colis |
| PUT | /api/v8/orders/{code} | Modifier un colis |
| DELETE | /api/v8/orders/{code} | Annuler un colis encore au statut Nouveau |
| POST | /api/v8/pickup-requests | Demander un ramassage |
Webhooks signés
Déclarez l'adresse de votre site dans Intégration API et choisissez l'événement : order.status_updated pour chaque changement de statut, ou order.delivered pour les livraisons seulement.
Chaque envoi est signé en HMAC-SHA256 dans l'en-tête X-Colivry-Signature. Vérifiez cette signature avec le secret du webhook avant de traiter le message.
{
"event": "order.delivered",
"order": {
"key": "CLV-2026110312000012345",
"state_id": 1,
"state": "Livrée",
"state_key": "..."
},
"timestamp": "2026-11-03T12:00:00+01:00"
}Compatible avec vos outils
L'API fonctionne avec tout outil capable d'envoyer une requête HTTP. Votre espace client fournit des exemples à adapter pour WooCommerce, Google Sheets et cURL.
Codes de réponse
- 201 : colis créé
- 401 : clé absente, invalide, expirée ou révoquée
- 404 : colis introuvable sur votre compte
- 422 : donnée refusée, la raison figure dans
message - 429 : trop de requêtes, réessayez un peu plus tard
Questions fréquentes
Qui peut utiliser l'API Colivry ?
Tout client Colivry. Les clés se créent depuis votre espace client, page Intégration API. Si vous n'avez pas encore de compte, inscrivez-vous sur Colivry ou appelez-nous.
Faut-il un développeur pour connecter ma boutique ?
Oui, ou une personne à l'aise avec le code : l'API se branche sur votre site par quelques lignes. Votre espace client contient des exemples à adapter pour WooCommerce, Google Sheets et les autres outils capables d'envoyer des requêtes HTTP.
Comment suivre mes colis depuis mon site ?
Deux solutions : interroger un colis avec GET /api/v8/orders/{code}, ou créer un webhook. Colivry appelle alors votre adresse à chaque changement de statut, sans que votre site ait à interroger l'API.
Puis-je modifier ou annuler un colis par l'API ?
Oui. Le destinataire, le téléphone, l'adresse, la ville, le secteur, la boutique et la remarque se modifient par l'API. Le prix et la quantité ne se modifient pas. L'annulation n'est possible que tant que le colis est au statut Nouveau.
Mes clés sont-elles protégées ?
La clé privée n'est affichée qu'une seule fois, à sa création, et n'est pas conservée en clair chez Colivry. Vous pouvez lui donner une durée d'un mois ou d'un an, et la révoquer à tout moment. Chaque clé ne donne accès qu'aux colis de son propre compte.
Connectez votre boutique à Colivry
Déjà client ? Votre clé est dans votre espace. Pas encore client ? Créez votre compte ou appelez-nous.