API
Leverings-API: maak uw leveringen aan vanuit uw eigen software
De REST-API van Shippr maakt uw leveringen aan, wijzigt en annuleert ze, geeft een directe prijsofferte en stuurt de trackinglink van elke bestemmeling terug. Ondertekende webhooks verwittigen u bij elke statuswijziging, en u test alles in een sandbox.
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"
}
]
}
}Wat de API doet
Uw leveringen, vanuit uw software
U maakt uw leveringen aan en volgt ze op
Aanmaken, wijzigen en annuleren, voor één bestemming of tientallen, met tijdvensters, pakketgrootte en referentienummer. Elke bestemming komt terug met haar trackinglink.
U kent de prijs voordat u bestelt
Een offerte-oproep geeft de prijs van de levering, in centen en in uw munt, voordat u ze aanmaakt.
Uw systemen krijgen elke status
Ondertekende webhooks sturen elke statuswijziging van een levering en haar bestemmingen door. Met de handtekening controleert u dat het bericht echt van Shippr komt.
Het verloop
Zo gaat het
- 01
U maakt uw account aan
En daarna een API-sleutel, in de instellingen van uw dashboard.
- 02
U test in de sandbox
Die aanvaardt dezelfde oproepen als de productie, zonder echte levering.
- 03
U gaat in productie
Uw oproepen gaan naar het productieadres, en uw leveringen vertrekken echt.
- 04
U ontvangt de statussen
Uw webhooks krijgen elke wijziging, en uw dashboard toont hun toestand.
Technische fiche
In de praktijk
| Formaat | REST en JSON, OpenAPI-documentatie |
|---|---|
| Authenticatie | API-sleutel aangemaakt in uw dashboard |
| Sandbox | api.demo.shippr.dev |
| Oproepen | Leveringen, bestellingen, directe prijsofferte, controle van de sleutel |
| Webhooks | Ondertekend, met zes nieuwe pogingen bij een mislukking |
| Limieten | 20 aanmaken per minuut, 100 prijsoffertes per 10 minuten |
| Kant-en-klare integraties | Shopify, Deliverect, Urbantz, Orkestro, Woop |
Informatie gecontroleerd op 16 oktober 2026
Integraties
Al verbonden met uw tools
Uw bestellingen worden leveringen, en de tracking komt terug in Shopify.
DeliverectDe bestellingen van uw restaurants gaan naar Shippr.
Shippr ontvangt uw taken als vervoerder.
U boekt Shippr vanuit uw platform.
Shippr levert voor de aangesloten winkelketens.
Veelgestelde vragen
De API van Shippr
Is er een testomgeving?
Ja. De sandbox, op api.demo.shippr.dev, aanvaardt dezelfde oproepen als de productie zonder een echte levering te starten.
Hoe authenticeer ik mij?
Met een API-sleutel die u in de instellingen van uw dashboard aanmaakt en in de header Authorization van elke oproep meestuurt. Een ontbrekende of ongeldige sleutel geeft een fout 401.
Kan ik de prijs kennen voordat ik een levering aanmaak?
Ja. De offerte-oproep geeft de prijs in centen en in uw munt, op basis van dezelfde gegevens als het aanmaken.
Wat staat er in de webhooks?
De identificatie en de nieuwe status van de levering of bestemming die veranderde. Elk bericht is ondertekend, en mislukt het, dan proberen wij het zes keer opnieuw. De details haalt u daarna op via de API.
Is mijn software al met Shippr verbonden?
Misschien: Shopify, Deliverect, Urbantz, Orkestro en Woop sturen hun leveringen al naar Shippr. Zo niet, dan volstaat de API, en onze documentatie beschrijft elke oproep.
Ontstaan uw bestellingen in uw eigen software?
Vertel ons welke: wij wijzen u de kortste weg, een bestaande integratie of de API.
Een voertuig voorbehouden voor elke zendingEen team dat elke dag bereikbaar is, van 6 tot 22 uur