如何在仅更改 URL 和密钥的情况下将 project44 v4 跟踪客户端迁移到 Dockflow？

操作指南问答
1

我的客户正在使用 project44 v4 的令牌交换和跟踪路由。需要更改哪些内容？

两个值：

  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":[]}

相同的标识符始终会到达相同的货运。每个集装箱也会获得自己的子 ID，该 ID 在读取和删除路由上均可用。已发布列表之外的标识符类型会返回 400。

按该 ID 读取。位置、费用和内容保持为空。Webhook 路由返回 403，因此 Dockflow 支持人员会添加你的目标地址。每次投递都包含历史读取的正文和一个 X-Dockflow-Signature 标头。

完整字段映射和签名校验：