J’ai un client conçu pour l’API océanique ShipsGo v2. Peut-il fonctionner sur Dockflow avec les mêmes chemins et les mêmes corps de requête ?
Oui. Changez deux valeurs :
- Définissez l’URL de base sur https://api.dockflow.com/compat/shipsgo/v2
- Placez une clé API Dockflow dans X-Shipsgo-User-Token. Créez la clé dans la API Console avec le scope Downstream.
Un cas concret, avec un faux jeton. Créez un envoi :
POST /compat/shipsgo/v2/ocean/shipments
X-Shipsgo-User-Token: prod_acme_FAKE-TOKEN
{"reference":"PO-5521","booking_number":"BK-7741"}
La réponse contient l’id de l’envoi. Relisez-le avec cet id. Cette réponse est raccourcie :
GET /compat/shipsgo/v2/ocean/shipments/74123
{"message":"SUCCESS","shipment":{"id":74123,
"reference":"PO-5521","booking_number":"BK-7741",
"status":"BOOKED"}}
Trois choses diffèrent. Les filtres de liste autres que l’id et le numéro de conteneur sont refusés, les followers et les tags restent vides, et les trajets aériens ne sont pas couverts. La liste est triée par dernière modification, du plus ancien au plus récent, et tout order_by est refusé. Tant que l’import n’a pas été exécuté, une lecture n’affiche que le numéro que vous avez envoyé. Les destinations de webhook sont ajoutées par le support Dockflow, et chaque livraison porte X-Shipsgo-Webhook-Signature.
Correspondance complète des champs et vérification de la signature :