韵达开放平台 API
接口简介
API鉴权说明
快递投放
校验运单号手机号
POST
禁投第三方校验
POST
电子面单
包裹信息接入
POST
电子面单取消
POST
电子面单下单
POST
电子面单余量查询
POST
电子面单更新
POST
电子面单打印
POST
停发查询
POST
散件下单
运单推送接口
POST
取消散件订单（新）
POST
预估运费
POST
散件下单(新)
POST
物流轨迹
物流轨迹推送
POST
物流轨迹查询
POST
物流轨迹订阅
POST
售后服务
物流工单下发
POST
国际件
国际进口下单
POST
外部发券
外部直发券
POST
发券结果查询
POST
停发查询开发中
POST/openapi-api/v1/bm/queryRoute
创建时间: 2025-06-03 00:39
请求参数
Header 参数
| 参数名 | 示例值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| app-key | {{app-key}} | 是 | string | 开放平台发放 |
| sign | {{sign}} | 是 | string | 签名说明参看附录《鉴权说明》 |
| req-time | {{$timestamp}} | 是 | string | 当前时间戳（毫秒） |
Body 参数application/json
数据结构
ordersarray<object>
可选
idstring
可选
唯一值
sender_addressstring
可选
发件地址
receiver_addressstring
可选
收件地址
示例数据
{
"orders": [
{
"id": 1001,
"sender_address": "上海市青浦区盈港东路6679号",
"receiver_address": "江苏省南京市玄武区中山北路1000号"
},
{
"id": 1002,
"sender_address": "江苏省南京市玄武区中山北路1000号",
"receiver_address": "上海市青浦区盈港东路6679号"
}
]
}响应示例
成功
HTTP状态码：200
内容格式：JSON
数据结构
响应示例
{
"code": "0000",
"data": {
"msg": "成功",
"response": [
{
"two_code": "",
"reach": "1",
"receiver_branch_code": "",
"warning_close_code": "0",
"remark": "",
"sender_branch_code": "200752",
"package_code": "J210039",
"sender_region_code": "310118",
"one_code": "472B",
"close_reason_two": "",
"receiver_region_code": "320102",
"package_name": "上海-短线",
"overzone": "0",
"id": "1",
"three_code": "000",
"close": "0",
"close_reason_one": ""
},
{
"two_code": "G058-00",
"reach": "1",
"receiver_branch_code": "200752",
"warning_close_code": "0",
"remark": "",
"sender_branch_code": "",
"package_code": "J200000",
"sender_region_code": "320102",
"one_code": "300A",
"close_reason_two": "",
"receiver_region_code": "310118",
"package_name": "上海分拨包",
"overzone": "0",
"id": "2",
"three_code": "52",
"close": "0",
"close_reason_one": ""
}
],
"status": "1"
},
"message": "请求成功",
"result": true,
"sub_code": null,
"sub_msg": null
}失败
HTTP状态码：200
内容格式：JSON
数据结构
未定义
响应示例
{
"result": false,
"code": "7777",
"message": "内部接口服务失败",
"sub_code" "s10",
"sub_msg": "参数校验不合法"
}最后更新: -