Developers · API
Une plateforme, pas une boîte noire
Clés API scopées, webhooks signés HMAC, idempotence. Branchez ShipAndCheap à n'importe quel site, ERP ou outil maison. Vos commandes entrent, votre tracking ressort — en temps réel.
POST /v1/orders
Authorization: Bearer sk_live_••••••••••
{
"orderNumber": "CMD-2026-1551",
"source": "mon-site.com",
"customer": {
"name": "Jean Dupont",
"email": "jean@exemple.fr",
"address": { "city": "Lyon", "postalCode": "69001", "country": "FR" }
},
"items": [{ "sku": "REF-123", "quantity": 1, "price": 49.9 }]
}
→ 201 Created · { "orderId": "...", "status": "pending" }Clés API scopées
Format sk_live_…, scopes par ressource (orders, shipments…), IP allowlist et rate limit. Le secret n'est affiché qu'une seule fois.
Webhooks signés
Signature HMAC (style Stripe : t=…,v1=…) + anti-rejeu. Vérifiez chaque événement, en toute confiance.
Idempotence
Pas de doublon, livraison fiable, rejeu possible. Vos intégrations restent cohérentes même en cas de retry.
Événements
Votre site, notifié en temps réel
Abonnez vos endpoints aux événements de la chaîne. À chaque étape — commande, expédition, retour — votre système reçoit un webhook signé.
- Couplage faible : votre site reste maître, ShipAndCheap pousse les mises à jour.
- Reprise sur erreur : retries avec backoff, journal de livraison, rejeu manuel.
order.createdorder.shippedorder.deliveredorder.cancelledshipment.createdshipment.in_transitshipment.deliveredshipment.exceptionreturn.createdreturn.received
Branchez votre stack en quelques minutes
Créez une clé, abonnez vos webhooks, envoyez votre première commande.