Méthode GET/partner
Relire une commande B2B par sa référence de commande. Droit dispatch:write.
Sur cette page
Vous relisez une commande par sa référence, celle que vous avez envoyée à la création. Le parcours complet est dans le guide Rattacher chaque unité à sa commande.
#Autorisation
Clef d'API dans l'en-tête Authorization, au format Bearer, avec le droit
dispatch:write. Une clef sans ce droit reçoit un 403 dont le message nomme le
droit manquant. L'offre de la marque de la clef doit comprendre l'accès API, et
la marque de l'expédition doit être sur l'offre Conformité + Identité.
Authorization: Bearer votre_clef#Plafond d'appels
Le même que les autres routes partenaires : un compteur par clef et un compteur pour la somme des clefs de votre marque, 120 appels par fenêtre de 60 secondes par défaut. Une lecture ne prélève rien sur le quota journalier.
#Paramètres de requête
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
order_ref | string | oui | La référence de commande, 1 à 100 caractères. |
brand_code | string | non | Avec une clef revendeur, la marque cliente. |
#Requête d'exemple
curl -i -X GET "https://api.sealtrust.io/v1/partner/dispatch/shipments?order_ref=SO-2026-1042" \
-H "Authorization: Bearer st_live_0000000000000000000000000000000000000000000000"#Réponse d'exemple
Code HTTP 200OK
Code HTTP 200, le même objet que la création, sans le champ created.
#Erreurs
| Code | Condition | Que faire |
|---|---|---|
| 401 | Clef absente, mal formée ou inconnue. | Envoyez Authorization: Bearer <votre clef> avec la clef entière. |
| 403 | La clef n'a pas le droit dispatch:write. Message Missing required scopes: dispatch:write. | Créez une clef qui porte ce droit. |
| 403 | La marque est sur l'offre Conformité. detail.code vaut OFFER_EXCLUDES_IDENTITY et detail.feature vaut dispatch. Rien n'est enregistré. | Passez à l'offre Conformité + Identité. Réessayer ne changera rien. |
| 429 | Plafond de débit ou quota journalier atteint. | Attendez le nombre de secondes de Retry-After, ou minuit en temps universel pour le quota. |
| 404 | Aucune commande de votre marque ne porte cette référence. | Vérifiez la référence et brand_code. |
Cette page vous a-t-elle été utile ?
Votre réponse ouvre un courriel pré-rempli dans votre messagerie, à destination de contact@sealtrust.io. Vous le relisez avant de l'envoyer.