任务描述
【数据库 -- 表设计】
无
【业务设计 -- 业务逻辑设计,梳理】

升级51track v3接口,出入参有调整

v3 接口地址:https://www.51tracking.com/v3/api-index#api-version

v2接口地址:https://api.51tracking.com/v2/trackings/batch

v2版本添加轨迹接口 post例子:

请求地址:

https://api.51tracking.com/v2/trackings/batch

请求头:

Content-Type: application/json
Tracking-Api-Key: 80eddf01-2cda-4c6d-9a55-8102c32e67a2
Accept: application/json

请求body:

[
    {
        "tracking_number": "20220113052816591439",
        "carrier_code": "yodel",
        "destination_code": "GB",
        "title": null,
        "logistics_channel": "物流部-英国北安普敦ES1仓-Yodel超大包",
        "customer_name": "3088",
        "customer_email": null,
        "customer_phone": null,
        "order_id": "JJD0002249753708285",
        "order_create_time": "2022/01/13 00:09:24",
        "tracking_ship_date": "20220113",
        "tracking_postal_code": "DD2 2AG",
        "tracking_account_number": null,
        "specialNumberDestination": null,
        "lang": null,
        "auto_correct": null,
        "comment": null
    }
]



【风险识别 -- 性能,并发,扩展】
无
【注意事项 - 编码规范、可能存在Bug、风险和业务关联】
完成后自测,结果更新到任务
需求描述

1.    需求概述

1.1. 背景

51track的API接口从V2升级到V3,V2接口已不再维护,所以为了避免轨迹查询异常,现需要升级V3

1.2. 目标

升级51track的API接口升级V3,以便轨迹能正常获取。

2.    功能设计

2.1. 轨迹对接51track

2.1.1 需求说明

需要将接口从V2升级到V3。

a)V3接口地址

https://www.51tracking.com/v3/api-index#%E6%B7%BB%E5%8A%A0%E7%89%A9%E6%B5%81%E5%8D%95%E5%8F%B7

b)涉及功能

推送订单至51track,对应‘添加物流单号’接口;

查询51track轨迹信息,对应‘获取查询接口’接口;

更新已推送给51track单号的物流商简码,对应‘修改单号信息’接口


注:其他开发自检下有无遗漏的接口。


验收标准
暂无
子任务
任务ID P 任务名称 截止日期 指派给 任务状态 消耗(h) 剩余(h) 操作
25159 P2 轨迹系统对接51track的API接口升级V3 -- 后端开发 -- 51track接口更新 0000-00-00 Closed 已关闭 0 4
25160 P2 轨迹系统对接51track的API接口升级V3 -- 后端开发 -- 51track接口调测 0000-00-00 Closed 已关闭 0 6
25161 P2 轨迹系统对接51track的API接口升级V3 -- 后端开发 -- 代码审查 0000-00-00 Closed 已关闭 0 1
历史记录  
  1. 2022-01-25 11:22:55, 由 liurenhu 创建。
  2. 2022-02-10 09:37:30, 由 liurenhu 编辑。
    修改了 父任务 ,旧值为 "0",新值为 "-1"。
    修改了 最初预计,旧值为 "0",新值为 "11"。
    修改了 预计剩余,旧值为 "0",新值为 "11"。
  3. 2022-02-10 09:37:30, 由 liurenhu 创建子任务 #25159 轨迹系统对接51track的API接口升级V3 -- 后端开发 -- 51track接口更新 , #25160 轨迹系统对接51track的API接口升级V3 -- 后端开发 -- 51track接口调测 , #25161 轨迹系统对接51track的API接口升级V3 -- 后端开发 -- 代码审查 。
    修改了 父任务 ,旧值为 "0",新值为 "-1"。
    修改了 最初预计,旧值为 "0",新值为 "11"。
    修改了 预计剩余,旧值为 "0",新值为 "11"。
    修改了 截止日期,旧值为 "2022-03-10",新值为 "0000-00-00"。
    修改了 预计开始,旧值为 "2022-03-08",新值为 "0000-00-00"。
  4. 2022-02-10 09:46:25, 由 liurenhu 编辑。
    修改了 任务描述,区别为:
    001- 【数据库 -- 表设计】无【业务设计 -- 业务逻辑设计,梳理】升级51track v3接口,出入参有调整【风险识别 -- 性能,并发,扩展】无【注意事项 - 编码规范、可能存在Bug、风险和业务关联】完成后自测,结果更新到任务
    001+ 【数据库 -- 表设计】无【业务设计 -- 业务逻辑设计,梳理】升级51track v3接口,出入参有调整
    002+ v3 接口地址:https://www.51tracking.com/v3/api-index#api-version
    003+ v2接口地址:https://api.51tracking.com/v2/trackings/batch
    004+ v2版本添加轨迹接口 post例子:
    005+ 请求地址:
    006+ https://api.51tracking.com/v2/trackings/batch
    007+
    008+ 请求头:
    009+ Content-Type: application/jsonTracking-Api-Key: 80eddf01-2cda-4c6d-9a55-8102c32e67a2Accept: application/json
    010+ 请求body:
    011+
    012+
    013+ [
    014+ {
    015+ "tracking_number":"20220113052816591439",
    016+ "carrier_code":"yodel",
    017+ "destination_code":"GB",
    018+ "title":null,
    019+ "logistics_channel":"物流部-英国北安普敦ES1仓-Yodel超大包",
    020+ "customer_name":"3088",
    021+ "customer_email":null,
    022+ "customer_phone":null,
    023+ "order_id":"JJD0002249753708285",
    024+ "order_create_time":"2022/01/1300:09:24",
    025+ "tracking_ship_date":"20220113",
    026+ "tracking_postal_code":"DD22AG",
    027+ "tracking_account_number":null,
    028+ "specialNumberDestination":null,
    029+ "lang":null,
    030+ "auto_correct":null,
    031+ "comment":null
    032+ }
    033+ ]
    034+
    035+
    036+
    037+
    038+ 【风险识别 -- 性能,并发,扩展】
    039+ 无【注意事项 - 编码规范、可能存在Bug、风险和业务关联】完成后自测,结果更新到任务
    001- 【数据库 -- 表设计】<br />无<br />【业务设计 -- 业务逻辑设计,梳理】<br />升级51track v3接口,出入参有调整<br />【风险识别 -- 性能,并发,扩展】<br />无<br />【注意事项 - 编码规范、可能存在Bug、风险和业务关联】<br />完成后自测,结果更新到任务<br />
    001+ 【数据库 -- 表设计】<br />无<br />【业务设计 -- 业务逻辑设计,梳理】<br /><p>升级51track v3接口,出入参有调整</p>
    002+ <p>v3 接口地址:https://www.51tracking.com/v3/api-index#api-version</p>
    003+ <p>v2接口地址:https://api.51tracking.com/v2/trackings/batch</p>
    004+ <p>v2版本添加轨迹接口 post例子:</p>
    005+ <p>请求地址:</p>
    006+ <p><span style="color:#505050;font-family:OpenSans, Helvetica, Arial, sans-serif;font-size:12px;background-color:#FFFFFF;">https://api.51tracking.com/v2/trackings/batch</span></p>
    007+ <p></p>
    008+ <p>请求头:</p>
    009+ <p>Content-Type: application/json<br />Tracking-Api-Key: 80eddf01-2cda-4c6d-9a55-8102c32e67a2<br />Accept: application/json<br /></p>
    010+ <p>请求body:</p>
    011+ <p>
    012+ </p><div style="color:#000000;background-color:#FFFFFE;font-family:Consolas;">
    013+ <div>[</div>
    014+ <div>{</div>
    015+ <div><span style="color:#a31515;">"tracking_number"</span>:<span style="color:#0451a5;">"20220113052816591439"</span>,</div>
    016+ <div><span style="color:#a31515;">"carrier_code"</span>:<span style="color:#0451a5;">"yodel"</span>,</div>
    017+ <div><span style="color:#a31515;">"destination_code"</span>:<span style="color:#0451a5;">"GB"</span>,</div>
    018+ <div><span style="color:#a31515;">"title"</span>:<span style="color:#0451a5;font-weight:bold;">null</span>,</div>
    019+ <div><span style="color:#a31515;">"logistics_channel"</span>:<span style="color:#0451a5;">"物流部-英国北安普敦ES1仓-Yodel超大包"</span>,</div>
    020+ <div><span style="color:#a31515;">"customer_name"</span>:<span style="color:#0451a5;">"3088"</span>,</div>
    021+ <div><span style="color:#a31515;">"customer_email"</span>:<span style="color:#0451a5;font-weight:bold;">null</span>,</div>
    022+ <div><span style="color:#a31515;">"customer_phone"</span>:<span style="color:#0451a5;font-weight:bold;">null</span>,</div>
    023+ <div><span style="color:#a31515;">"order_id"</span>:<span style="color:#0451a5;">"JJD0002249753708285"</span>,</div>
    024+ <div><span style="color:#a31515;">"order_create_time"</span>:<span style="color:#0451a5;">"2022/01/1300:09:24"</span>,</div>
    025+ <div><span style="color:#a31515;">"tracking_ship_date"</span>:<span style="color:#0451a5;">"20220113"</span>,</div>
    026+ <div><span style="color:#a31515;">"tracking_postal_code"</span>:<span style="color:#0451a5;">"DD22AG"</span>,</div>
    027+ <div><span style="color:#a31515;">"tracking_account_number"</span>:<span style="color:#0451a5;font-weight:bold;">null</span>,</div>
    028+ <div><span style="color:#a31515;">"specialNumberDestination"</span>:<span style="color:#0451a5;font-weight:bold;">null</span>,</div>
    029+ <div><span style="color:#a31515;">"lang"</span>:<span style="color:#0451a5;font-weight:bold;">null</span>,</div>
    030+ <div><span style="color:#a31515;">"auto_correct"</span>:<span style="color:#0451a5;font-weight:bold;">null</span>,</div>
    031+ <div><span style="color:#a31515;">"comment"</span>:<span style="color:#0451a5;font-weight:bold;">null</span></div>
    032+ <div>}</div>
    033+ <div>]</div>
    034+ </div>
    035+
    036+ <p><br /></p>
    037+ <p><br /></p>
    038+ 【风险识别 -- 性能,并发,扩展】<br />
    039+ 无<br />【注意事项 - 编码规范、可能存在Bug、风险和业务关联】<br />完成后自测,结果更新到任务<br />
  5. 2023-01-05 09:35:56, 由 梁欢 编辑。
    修改了 预计剩余,旧值为 "11",新值为 "7"。
  6. 2023-01-05 09:35:56, 由 梁欢 编辑。
    修改了 预计剩余,旧值为 "7",新值为 "1"。
  7. 2023-01-05 09:35:56, 由 梁欢 关闭。
    修改了 预计剩余,旧值为 "1",新值为 "0"。
    修改了 任务状态,旧值为 "wait",新值为 "closed"。
    修改了 指派给 ,旧值为 "liurenhu",新值为 "closed"。
    修改了 由谁关闭,旧值为 "",新值为 "lianghuan"。
    修改了 关闭时间,旧值为 "0000-00-00 00:00:00",新值为 "2023-01-05 09:35:56"。
    修改了 关闭原因,旧值为 "",新值为 "done"。
所属迭代 【分支】产品中心2月非正常更新版本(2022年)
所属模块 赛盒科技  物流轨迹
相关需求 轨迹系统对接51track的API接口升级V3
指派给 Closed 于 2023-01-05 09:35:56
任务类型 后端
任务标签 初始
开发组
任务状态 已关闭
进度 0%
优先级 P2
关键词
抄送给
由谁创建 liurenhu 于 2022-01-25 11:22:55
由谁完成 暂无
由谁取消 暂无
由谁关闭 梁欢 于 2023-01-05 09:35:56
关闭原因 已完成
最后编辑 梁欢 于 2023-01-05 09:35:56
团队 最初预计 总计消耗 预计剩余
工时信息
最初预计 11工时
总计消耗 0工时
预计剩余 0工时
预计开始 0000-00-00
实际开始 0000-00-00
截止日期 0000-00-00