WindwardのGraphQLトラッキングクライアントはDockflowで動作しますか？また、何を変更する必要がありますか？

ハウツーQ&A
1

私のクライアントはWindwardの海洋追跡APIにGraphQLを送信しています。クエリはそのまま使えますか？

はい、クエリとミューテーションはそのまま使えます。URLと認証情報は変更になりますが、この2つはDockflow独自の設計です。Windwardが公開していないためです：

  1. https://api.dockflow.com/compat/windward/graphql に送信します
  2. x-api-key、またはBearerトークンとしてDockflowのAPIキーを送信します。クライアントがpublicAPITokenを呼び出す場合は、キーをclientSecretに入れてください。

このサーフェスへの最初の移行は、検証としてDockflowと共同で実行するため、サポートに連絡して計画を立ててください。

偽のキーを使った実行例：

POST /compat/windward/graphql
x-api-key: prod_acme_FAKE-TOKEN

{"query":"mutation($s:[TrackedShipmentInput!]!){upsertTrackedShipments(shipments:$s){id}}",
 "variables":{"s":[{"bol":"BL-7741","metadata":{"jobNumber":"PO-5521"}}]}}

応答にはidが含まれます：

{"data":{"upsertTrackedShipments":[{"id":"000000000000000000012345"}]}}

Windwardが発行したIDは解決できないため、各出荷を一度だけupsertしてください。リストはidとコンテナ番号のみでフィルタリングできます。sortおよびorderBy引数は受け入れられますが無視されます。船舶および企業のスクリーニングは対象外です。各Webhook配信にはX-Dockflow-Signatureヘッダーが付与されます。

フィールドマッピングの詳細と署名検証：