物流轨迹订阅接口
注意:该接口需与1.19物流轨迹推送接口搭配使用,主要给三方erp用的,商家自研系统无需接入该接口
基本信息
| 接口名称 | |
|---|---|
| 请求方式 | Post application/x-www-form-urlencoded |
| 功能描述 | 外部ERP调用该接口订阅运单物流轨迹 |
| 编码 | UTF-8 |
入参
| 项目 | 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|---|
| 对接码 | logistic_provider_id | String | 是 | 菜鸟侧提供 | |
| 签名 | data_digest | String | 是 | Base64(Md5(logistics_interface+双方约定的secretKey)) ,0.2 签名方法 | x-www-form-urlencoded格式可能会出现加号变空格的情况,发请求之前可以对签名进行urlencode |
| 业务报文 | logistics_interface | String | 是 | JSON |
logistics_interface内容
| 项目 | 名称 | 类型 | 必填 | 描述 | 示例 |
|---|---|---|---|---|---|
| 运单号 | bizId | String | 是 | 运单号 | 621000153894 |
出参
| 项目 | 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|---|
| 成功标识 | success | Boolean | 是 | ||
| 错误码 | errorCode | String | 否 | ||
| 错误说明 | errorMsg | String | 否 |
示例报文
url:
http://edi-daily.xpm.cainiao.com/ext/gateway/ediStandardTraceSubscribe/api
请求:
仅供参考,实际测试账号需联系菜鸟速递开发提供
logistic_provider_id: edi_test_json
logistics_interface: {"bizId":"621000153894"}
data_digest: 4HQeJTYreTvD57k8tU8xCQ==
返回:
{"success":true}