API
API de livraison : créez vos livraisons depuis votre propre logiciel
L’API REST de Shippr crée, modifie et annule vos livraisons, donne un devis instantané et renvoie le lien de suivi de chaque destinataire. Des webhooks signés vous préviennent à chaque changement de statut, et un environnement de test vous permet de tout essayer avant la mise en production.
POST https://api.shippr.io/v1/deliveries
Authorization: Bearer <API_KEY>
Content-Type: application/json
{
"desired_pickup_time": "2026-10-16T06:30:00Z",
"pickup_location": {
"last_name": "Verhaegen",
"company": "Maison Verhaegen",
"address": "Rue de Birmingham 102, 1080 Bruxelles"
},
"destinations": [
{
"location": {
"last_name": "Lemaire",
"company": "Boucherie Lemaire",
"phone": "+3225550123",
"address": "Chaussée de Waterloo 512, 1180 Uccle"
},
"package_type": "MEDIUM",
"time_window_start": "2026-10-16T07:00:00Z",
"time_window_end": "2026-10-16T08:00:00Z"
}
],
"is_food": true
}HTTP/1.1 201 Created
{
"data": {
"uuid": "3f6c2a9e-8b41-4d2f-a7c5-1e9b0d4c6a52",
"status": "CREATED",
"destinations": [
{
"uuid": "b81d7e04-5c3a-4f6b-9e2d-0a7c4f1b3e98",
"status": "PENDING",
"tracking_link": "https://track.shippr.io/t/7HQ2KPX4ZM9RWT1BDN6C"
}
]
}
}Ce que fait l’API
Vos livraisons, depuis votre logiciel
Vous créez et suivez vos livraisons
Création, modification et annulation, pour une destination ou des dizaines, avec créneaux, taille des colis et numéro de référence. Chaque destination revient avec son lien de suivi.
Vous connaissez le prix avant de commander
Un appel de devis renvoie le prix de la livraison, en centimes et dans votre devise, avant que vous la créiez.
Vos systèmes reçoivent chaque statut
Des webhooks signés envoient chaque changement de statut d’une livraison et de ses destinations. La signature vous permet de vérifier que l’envoi vient bien de Shippr.
Le parcours
Comment ça se passe
- 01
Vous créez votre compte
Puis une clé API, dans les réglages de votre tableau de bord.
- 02
Vous essayez dans l’environnement de test
Il accepte les mêmes appels que la production, sans livraison réelle.
- 03
Vous passez en production
Vos appels vont à l’adresse de production, et vos livraisons partent pour de vrai.
- 04
Vous recevez les statuts
Vos webhooks reçoivent chaque changement, et votre tableau de bord affiche leur état.
Fiche technique
En pratique
| Format | REST et JSON, documentation OpenAPI |
|---|---|
| Authentification | Clé API générée dans votre tableau de bord |
| Environnement de test | api.demo.shippr.dev |
| Appels | Livraisons, commandes, devis instantané, vérification de clé |
| Webhooks | Signés, avec six nouvelles tentatives en cas d’échec |
| Limites | 20 créations par minute, 100 devis par 10 minutes |
| Intégrations prêtes | Shopify, Deliverect, Urbantz, Orkestro, Woop |
Informations vérifiées le 16 octobre 2026
Intégrations
Déjà connecté à vos outils
Vos commandes deviennent des livraisons, et le suivi revient dans Shopify.
DeliverectLes commandes de vos restaurants partent chez Shippr.
Shippr reçoit vos tâches comme transporteur.
Vous réservez Shippr depuis votre plateforme.
Shippr livre pour les enseignes connectées.
Questions fréquentes
L’API Shippr
Existe-t-il un environnement de test ?
Oui. L’environnement de test, à l’adresse api.demo.shippr.dev, accepte les mêmes appels que la production sans déclencher de vraie livraison.
Comment est-ce que je m’authentifie ?
Avec une clé API que vous générez dans les réglages de votre tableau de bord et que vous envoyez dans l’en-tête Authorization de chaque appel. Une clé absente ou invalide renvoie une erreur 401.
Puis-je connaître le prix avant de créer une livraison ?
Oui. L’appel de devis renvoie le prix en centimes et dans votre devise, à partir des mêmes informations que la création.
Que contiennent les webhooks ?
L’identifiant et le nouveau statut de la livraison ou de la destination qui a changé. Chaque envoi est signé, et s’il échoue, nous réessayons six fois. Le détail s’obtient ensuite par l’API.
Mon logiciel est-il déjà connecté à Shippr ?
Peut-être : Shopify, Deliverect, Urbantz, Orkestro et Woop envoient déjà leurs livraisons à Shippr. Sinon, l’API suffit, et notre documentation décrit chaque appel.
Vos commandes naissent dans votre propre logiciel ?
Dites-nous lequel : nous vous indiquons le chemin le plus court, intégration existante ou API.
Un véhicule réservé à chaque envoiUne équipe joignable 7 jours sur 7, de 6 h à 22 h