Ho un client scritto per l’API ocean di ShipsGo v2. Può funzionare su Dockflow con gli stessi percorsi e corpi delle richieste?
Sì. Cambia due valori:
- Imposta l’URL di base su https://api.dockflow.com/compat/shipsgo/v2
- Inserisci una chiave API di Dockflow in X-Shipsgo-User-Token. Crea la chiave nella API Console con lo scope Downstream.
Un caso di esempio, con un token fittizio. Crea una spedizione:
POST /compat/shipsgo/v2/ocean/shipments
X-Shipsgo-User-Token: prod_acme_FAKE-TOKEN
{"reference":"PO-5521","booking_number":"BK-7741"}
La risposta contiene l’id della spedizione. Rileggila con quell’id. Questa risposta è abbreviata:
GET /compat/shipsgo/v2/ocean/shipments/74123
{"message":"SUCCESS","shipment":{"id":74123,
"reference":"PO-5521","booking_number":"BK-7741",
"status":"BOOKED"}}
Tre cose sono diverse. I filtri di elenco diversi da id e numero di container vengono rifiutati, i follower e i tag restano vuoti e le rotte aeree non sono coperte. L’elenco è ordinato per ultima modifica, dal più vecchio al più recente, e ogni order_by viene rifiutato. Finché l’importazione non è stata eseguita, una lettura mostra solo il numero che hai inviato. Le destinazioni dei webhook vengono aggiunte dal supporto di Dockflow e ogni consegna riporta X-Shipsgo-Webhook-Signature.
Mappatura completa dei campi e verifica della firma: