URLとシークレットを変更するだけでproject44 v4トラッキングクライアントをDockflowに移行する方法は？

ハウツーQ&A
1

私のクライアントは project44 v4 のトークン交換とトラッキングルートを使用しています。何を変更する必要がありますか？

2つの値：

  1. ベースURLを https://api.dockflow.com/compat/project44 に設定します。
  2. クライアントシークレットとして Dockflow の API キーを使用します。API コンソールで Downstream スコープを指定してキーを作成してください。

偽のシークレットを使った具体例です。交換するとシークレットがトークンとして返されます：

POST /compat/project44/api/v4/oauth2/token
grant_type=client_credentials&client_id=my-app&client_secret=prod_acme_FAKE-TOKEN

{"access_token":"prod_acme_FAKE-TOKEN","token_type":"BEARER","expires_in":3600}

トラッキングを開始します。この回答は短縮されています：

POST /compat/project44/api/v4/shipments/tracking
Authorization: Bearer prod_acme_FAKE-TOKEN

{"identifiers":[{"type":"BILL_OF_LADING","value":"BL-7741"}]}

{"id":"00000000-0000-4000-8000-000000012345",
 "identifiers":[{"type":"BILL_OF_LADING","value":"BL-7741"}],
 "problems":[]}

同じ識別子は常に同じ shipment に到達します。各コンテナにはそれぞれ専用の子 id も割り当てられ、これは読み取りルートと削除ルートで機能します。公開されているリストにない識別子タイプは 400 を返します。

その id で読み取ります。位置、コスト、内容は空のままです。webhook ルートは 403 を返すため、Dockflow サポートがあなたの宛先を追加します。各配信には履歴読み取りの本文と X-Dockflow-Signature ヘッダーが含まれます。

フィールドマッピングの全体と署名チェック：