全部
电子面单
物流轨迹
物流发货
在线测试

快递查询地图轨迹


接口地址: http://api.vv-tool.com/tool/accounts/kd-query-express


接口介绍: 快递查询地图轨迹


请求方式: POST


返回格式: JSON


接口收费: 联系客服


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

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

请求参数

参数 类型 必选 描述
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 未授权店铺 根据返回链接进行扫码授权