文档
测试

快递查询

GET
/tool/v1/getExpress

接口描述

快递查询功能

请求头

参数名
类型
描述
必填
ACCESSTOKEN
String
用户(设备)唯一标识
必填

请求参数

参数名
类型
描述
必填
expressNo
String
快递单号
必填

响应参数

参数名
类型
描述
必填
code
int
返回结果码 1000- 成功 非1000-失败
必填
data
object
返回结果对象
必填
code
string
快递查询结果码 :-1单号或快递公司错误;201快递单号错误;203 快递公司不存在;204 错误单号重复;205 没有轨迹;207 该单号被限制,错误单号;OK 查询成功
必填
courier
string
快递员 或 快递站(没有则为空)
必填
courierPhone
string
快递员电话
必填
expressState
string
物流状态解释
必填
list
array
物流位置列表
必填
content
string
示例:客户签收人: 家门口麻烦给个快递员五星好评 已签收 感谢使用圆通速递,期待再次为您服务 如有疑问请联系:17621539435,投诉电话:021-34978513
必填
time
string
示例:2020-08-25 14:16:11
必填
logo
string
快递公司logo
必填
msg
string
提示信息
必填
name
string
快递名称
必填
no
string
快递单号
必填
phone
string
快递公司电话
必填
resultInfo
string
code对应的解释
必填
state
string
物流状态:-1:单号或代码错误;0:暂无轨迹;1:快递收件;2:在途中;3:签收;4:问题件 5.疑难件 6.退件签收
必填
takeTime
string
发货到收货消耗时长 (截止最新轨迹)
必填
type
string
快递公司编码
必填
updateTime
string
快递轨迹信息最新时间
必填
message
string
返回结果信息
必填
size
int
返回对象长度
必填

说明 / 示例

{ "code": 1000, "data": { "code": "OK", "courier": "", "courierPhone": "17621539435", "expressState": "已签收", "list": [ { "content": "客户签收人: 家门口麻烦给个快递员五星好评 已签收 感谢使用圆通速递,期待再次为您服务 如有疑问请联系:17621539435,投诉电话:021-34978513", "time": "2020-08-25 14:16:11" }, { "content": "【上海市长宁区福泉公司】 派件中 派件人: 赵东东 电话 17621539435 如有疑问,请联系:021-34978513", "time": "2020-08-25 08:02:08" }, { "content": "【上海市长宁区福泉公司】 已收入", "time": "2020-08-25 06:38:55" }, { "content": "【上海转运中心】 已发出 下一站 【上海市长宁区福泉公司】", "time": "2020-08-25 03:40:31" }, { "content": "【上海转运中心公司】 已收入", "time": "2020-08-25 03:12:07" }, { "content": "【泰州转运中心】 已发出 下一站 【上海转运中心公司】", "time": "2020-08-24 22:15:14" }, { "content": "【泰州转运中心公司】 已收入", "time": "2020-08-24 21:54:09" }, { "content": "【江苏省扬州市】 已发出 下一站 【泰州转运中心公司】", "time": "2020-08-24 16:05:20" }, { "content": "【江苏省扬州市公司】 已收件 取件人: 田刚刚 (15358508015)", "time": "2020-08-24 16:05:10" } ], "logo": "https://img3.fegine.com/express/yto.jpg", "msg": "查询成功", "name": "圆通速递", "no": "YT4738720418022", "phone": "95554", "resultInfo": "查询成功", "state": "3", "takeTime": "0天22小时11分", "type": "YTO", "updateTime": "2020-08-25 14:16:11" }, "message": "查询成功", "size": 1 }