ShipsGo v2クライアントを書き換えずにDockflowに向ける方法は?

ShipsGo v2の海運API向けに作ったクライアントがあります。同じパスとボディでDockflow上で動かせますか?

はい。変更する値は2つだけです:

  1. ベースURLを https://api.dockflow.com/compat/shipsgo/v2 に設定します。
  2. 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 が付きます。

フィールドの完全なマッピングと署名の検証: