ShipsGo v2の海運API向けに作ったクライアントがあります。同じパスとボディでDockflow上で動かせますか?
はい。変更する値は2つだけです:
- ベースURLを https://api.dockflow.com/compat/shipsgo/v2 に設定します。
- DockflowのAPIキーを X-Shipsgo-User-Token に入れます。キーはAPIコンソールでDownstreamスコープを付けて作成してください。
実際の例を、偽のトークンで示します。出荷を作成します:
POST /compat/shipsgo/v2/ocean/shipments
X-Shipsgo-User-Token: prod_acme_FAKE-TOKEN
{"reference":"PO-5521","booking_number":"BK-7741"}
応答には出荷IDが含まれます。そのIDで読み戻します。以下は短縮した応答です:
GET /compat/shipsgo/v2/ocean/shipments/74123
{"message":"SUCCESS","shipment":{"id":74123,
"reference":"PO-5521","booking_number":"BK-7741",
"status":"BOOKED"}}
異なる点は3つあります。idとコンテナ番号以外のリストフィルターは拒否され、フォロワーとタグは空のままで、航空路線には対応していません。リストは最終変更順で古いものから並び、order_byはすべて拒否されます。インポートが実行されるまで、読み取りでは送信した番号のみが表示されます。Webhookの送信先はDockflowサポートが追加し、各配信には X-Shipsgo-Webhook-Signature が付きます。
フィールドの完全なマッピングと署名の検証: