韵达 API
  1. 物流轨迹
韵达 API
  • 接口简介
  • API 鉴权说明
    • API 鉴权说明
  • 电子面单
    • 电子面单取消接口
      POST
    • 电子面单下单
      POST
    • 电子面单余量查询接口
      POST
    • 电子面单更新接口
      POST
  • 散件下单
    • 运单推送接口
      POST
    • 散单取消接口
      POST
    • 预估运费接口
      POST
    • 散件下单接口
      POST
  • 物流轨迹
    • 物流轨迹推送
      POST
    • 物流轨迹查询
      POST
    • 物流轨迹订阅
      POST
  • 国际件
    • 国际进口下单接口
      POST
  • 页面嵌入
    • 微信小程序嵌入
    • 微信公众号接入
    • h5页面嵌入
  1. 物流轨迹

物流轨迹订阅

POST
/outer/logictis/subscribe

接口描述#

为方便各合作方快速安全的查询到物流轨迹信息,特制定此接口规范,请各合作方严格遵循手册中的各项规范及要求,并同时做好相关的保密工作,谢谢配合。
1:合作方先通过订阅接口将运单信息给到韵达才能有后续的物流轨迹服务;
2:运单订阅后的有效期是60天;
3:合作方需合理控制调用物流查询接口频率;
4:申请使用物流轨迹订阅接口,请联系韵达市场营销中心(联系方式:021-39296012或zhangyu6211@yundaex.com)建立合作,完成合作确认后获取接口使用权限(邮件需说明合作内容与公司名);
错误码说明
s00 未知错误
s01 非法的合作商账户
s02 非法的主机来源
s03 非法的数据签名
s04 非法的请求类型
s06 非法的订单号
s07 账户不具有访问本功能的权限
s08 查询的运单没有经过指定账号进行订阅操作
s09 当天下单量超出限额
s10 当天查询量超出限额
s11 无效的指令操作
s12 没有指定有效的查询条件
s13 非法运单号
s14 数据格式错误
s15 发件人手机错误
s16 发件人电话错误
s17 收件人手机错误
s18 收件人电话错误
s51 发件人信息不完整
s52 收件人信息不完整
s71 发件人所在地区服务已关闭
s72 收件人所在地区服务已关闭
s91 信息不完整
s97 数据更新失败
s98 数据保存失败
s99 服务器错误
s100 服务器网络波动,建议稍后重试
e03 黑名单客户
e99 其他原因
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://openapi.yundaex.com/openapi-api/outer/logictis/subscribe' \
--header 'app-key;' \
--header 'sign;' \
--header 'req-time;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "orders": [
        {
            "orderid": "9987765544332",
            "mailno": "3309876541228",
            "receiver": {
                "address": "青浦区盈港东路 6679 号",
                "city": "上海市",
                "county": "青浦区",
                "mobile": "0553-9876542",
                "name": "李四",
                "phone": 17601205970,
                "province": "上海市"
            },
            "sender": {
                "address": "盈港东路 7766 号",
                "city": "上海市",
                "county": "青浦区",
                "mobile": "0553-9876542",
                "name": "张三",
                "phone": 17601205970,
                "province": "上海市"
            }
        },
        {
            "orderid": "8876544333322",
            "mailno": "3309876541228",
            "receiver": {
                "address": "青浦区盈港东路 6679 号",
                "city": "上海市",
                "county": "青浦区",
                "mobile": "0553-9876542",
                "name": "李四",
                "phone": 17601205970,
                "province": "上海市"
            },
            "sender": {
                "address": "盈港东路 7766 号",
                "city": "上海市",
                "county": "青浦区",
                "mobile": "0553-9876542",
                "name": "张三",
                "phone": 17601205970,
                "province": "上海市"
            }
        }
    ]
}'
响应示例响应示例
{
    "result": true,
    "code": "0000",
    "message": "请求成功",
    "data": [
        {
            "result": true,
            "orderid": "8876544333322"
        },
        {
            "result": true,
            "orderid": "8876544333322"
        }
    ]
}

请求参数

Header 参数
app-key
string 
开放平台发放
必需
默认值:
{{app-key}}
sign
string 
必需
签名说明参看附录《鉴权说明》
默认值:
{{sign}}
req-time
string 
当前时间戳(毫秒)
必需
默认值:
{{$timestamp}}
Body 参数application/json
orders
array [object {4}] 
订单详情集合
必需
orderid
string 
订单号
必需
mailno
string 
必需
运单号(快递面单上的韵达单号)
receiver
object 
receiver
必需
sender
object 
发件信息
必需
示例

返回响应

🟢200成功
application/json
Body
code
string 
响应编码
必需
message
string 
响应内容
必需
result
boolean 
是否成功
必需
data
array [object {2}] 
返回对象信息
必需
orderId
string 
订单号
必需
result
boolean 
必需
订阅结果(true-成功,false-失败)

【韵达】API开发者 微信交流群

用微信扫右侧二维码,加入【韵达】API开发者 交流群,互助沟通

扫码加入交流群
修改于 2021-11-10 04:26:26
上一页
物流轨迹查询
下一页
国际进口下单接口
Built with