V兔API开放平台

参数	类型	必选	描述
com	string	是	查询的快递公司的编码，一律用小写字母
num	string	是	查询的快递单号，单号的最大长度是 32 个字符
phone	string	否	收、寄件人的电话号码（手机和固定电话均可，只能填写一个，顺丰速运和丰网速运必填，其他快递公司选填。如座机号码有分机号，分机号无需上传。）
from	string	是	出发地信息，如：广东省深圳市南山区金蝶软件园
to	string	是	目的地信息，如：北京朝阳区国际金融大厦
show	string	否	返回格式：0：JSON 格式（默认），1：XML，2：HTML，3：text
order	string	否	返回结果排序：desc 降序（默认）,asc 升序
orderTime	string	否	订单下单时间，格式为（yyyy-MM-dd HH:mm:ss）如：2020-12-16 12:59:59

请求示例

{
    "com": "ems",
    "num": "em263999513jp",
    "phone": "13868688888",
    "from": "广东省深圳市南山区金蝶软件园",
    "to": "北京朝阳区国际金融大厦",
    "show": "0",
    "order": "desc",
    "orderTime": "2020-12-16 12:59:59"
}

请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

响应参数

名称	类型	描述
code	int	返回状态码
msg	string	返回码描述
msec	int	接口执行时间
time	int	接口返回时间
data	object	数据信息
--message	String	消息体，请忽略
--state	Integer	快递单当前状态，包括 0 在途，1 揽收，2 疑难，3 签收，4 退签，5 派件，6 退回，7 转单，10 待清关，11 清关中，12 已清关，13 清关异常，14 收件人拒签等 13 个状态
--status	Integer	通讯状态，请忽略
--condition	String	快递单明细状态标记，暂未实现，请忽略
--ischeck	Integer	是否签收标记，请忽略，明细状态请参考 state 字段
--com	String	快递公司编码，一律用小写字母
--nu	String	单号
--trailUrl	String	轨迹地图链接
--arrivalTime	String	预计到达时间
--totalTime	String	平均耗时
--remainTime	String	到达还需多少时间
--isLoop	Boolean	是否存在环路
--routeInfo		路由信息
----from		出发地行政区信息
------number		政区信息编码
------name		政区信息名
----cur		当前地行政区信息
------number		政区信息编码
------name		政区信息名
----to		目的地行政区信息
------number		政区信息编码
------name		政区信息名
--data	data	最新查询结果，数组，包含多项，全量，倒序（即时间最新的在最前），每项都是对象，对象包含字段请展开
----context	String	内容
----time	String	时间，原始格式
----ftime	String	格式化后时间
----status	String	本数据元对应的签收状态，只有实时查询接口中提交 resultv2 标记后才会出现
----areaCode	String	本数据元对应的行政区域的编码，只有实时查询接口中提交 resultv2 标记后才会出现
----areaName	String	本数据元对应的行政区域的名称，只有实时查询接口中提交 resultv2 标记后才会出现
--withholding_money	int	该接口扣费金额（点券）

返回数据

{
  "code": 0,
  "mag": "",
  "msec": "",
  "time": 1656564848,
  "data": {
    "message": "ok",
    "nu": "YT4781863654577",
    "ischeck": "1",
    "com": "yuantong",
    "status": "200",
    "data": [
        {
            "time": "2020-11-30 13:19:56",
    	    "context": "圆通合作点【喵站】快件已到达财富金街院里3号底商驿站,联系电话18744663997",
            "ftime": "2020-11-30 13:19:56",
            "areaCode": null,
            "areaName": null,
            "status": "在途"
        },
        {
            "time": "2020-09-12 17:40:58",
            "context": "【广东省深圳市平湖公司】 已收件 取件人: 刘杰珍 (18128837173)",
            "ftime": "2020-09-12 17:40:58",
            "areaCode": "CN440307003000",
            "areaName": "广东,深圳市,龙岗区,平湖",
            "status": "揽收"
        }
    ],
    "state": "3",
    "condition": "00",
    "routeInfo": {
        "from": {
            "number": "CN4403",
            "name": "广东,深圳市"
        },
        "cur": {
            "number": "CN6101",
            "name": "陕西,西安市"
        },
        "to": {
            "number": "CN6101",
            "name": "陕西,西安市"
        }
    },
    "isLoop": false,
    "trailUrl": "https://api.kuaidi100.com/tools/map/bc80574d538262aecc897a469151f0e3",
    "arrivalTime": "2020-12-19 12:00",
    "totalTime": "2天1小时",
    "remainTime": "1天2小时"
}
}

响应代码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
103	旺旺账号不存在	检查您输入的旺旺号是否正确
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API 调用次数不足，请前往网站兑换次数。	前往官网充值该接口调用次数
302	未授权店铺	根据返回链接进行扫码授权

快递查询地图轨迹

请求头参数

请使用新的生成 token 接口 点击查看详情

请求参数

请求示例

请求代码示例

响应参数

返回数据

响应代码

请使用新的生成 token 接口点击查看详情