快递单号订阅自动推送接口-快递物流轨迹订阅-
版本: V1.0 | 交付方式: API |
适用于: 其他 | 上架日期: 2024-06-13 01:51:52 |
一、产品介绍 :
【 快递查询 自动推送 快递物流轨迹订阅】接口可自动推送快递信息,按单号收费(自动识别单号),定时跟踪监控实时返回物流信息。覆盖全球快递 物流查询 接口,包括600家以上快递公司。—— 我们只做精品!
二、产品特性:
1,全面性 覆盖全面,支持近两千家快递公司查询;
2,实时性,直连各快递公司,数据实时更新;
三、更多产品:
更多商品请点击链接 https://marketplace.huaweicloud.com/seller/0cc531c0b780f23e0f1ec014dadd08a0 进入聚美智数店铺查看。
四、推送说明:
当物流轨迹发生变动时,聚美智数将物流轨迹数据推送至接入商提供地址为callBackUrl的接口
1、数据结构
{ "expressCode":"EMS", // 快递公司编号 详见:快递公司编码对照表 "number":"9796578035309",// 运单编号 "logisticsStatus":"SIGN", // 当前最新物流状态 详见:物流状态编码对照表 "logisticsStatusDesc":"已签收", // 当前最新物流状态描述 "details":[ // 完整的物流轨迹 { "time":1632123146000, // 物流变更时间 "logisticsStatus":"ACCEPT", // 物流状态 详见:物流状态编码对照表 "subLogisticsStatus":"ACCEPT", // 物流子状态 详见:物流状态编码对照表 "desc":"【杭州电商仓配揽投部】已收寄,揽投员:刘岭,电话:13754324900", //物流路由信息描述内容 "areaCode":"CN330100000000", // 路由节点所在地区行政编码 "areaName":"浙江省,杭州市" // 路由节路由节点所在地区 }, { "time":1632140994000, "logisticsStatus":"TRANSPORT", "subLogisticsStatus":"TRANSPORT", "desc":"离开【杭州电商仓配揽投部】,下一站【杭州萧山区东片集散中心】", "areaCode":"CN330100000000", "areaName":"浙江省,杭州市" }, ... ] }
2、返回接收结果
接入商需要根据接受成功、接受失败样例,返回接收处理结果返回给聚美智数
如果是接收失败,聚美智数会再次推送,最多推送3次
//接收成功
{ "success":true }
// 接收失败
{ "success":false, "msg": "接收失败" }
3、接收示例(java)
@PostMapping("callbackUrl") public Map<String,Object> receive(@RequestBody String data, HttpServletRequest request) { log.info("接收到快递物流推送数据: {}", data); Map<String,Object> map = new HashMap<>(); // 1、处理自己的业务逻辑 // 2、根据处理结果返回接收结果 if (处理成功) { map.put("success",true); } else { map.put("success",false); map.put("msg","接收失败, xxx"); } return map; }
4、快递公司编码对照表
请点击最下方 【使用指南】中见快递公司编码对照表
5、物流状态对照表
请点击最下方【使用指南】中见物流状态对照表