隐私通话API
身份验证API
自然语言API
短信语音API
游戏赛事API
数据服务API
异步通知API
安全工具API
图像/人像处理
商户订单API
其他鉴权API
会员工具API
中医Ai智慧API
业务充值API
SDK与工具下载
快递物流查询服务
接口调用费用:0.01元/次,费用将在请求成功(无论是物流单号是否存在)后扣取。
本接口实时返回数据,不做缓存。请确保账户余额≥10元,否则无法调用。
请求地址
请求环境 | 接口地址 |
---|---|
ALL | /BusinessApi/express.api |
请求参数(GET/POST)
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
appid | String | 是 | 20 | 中莱开放平台的应用ID | 14000000000000 |
secret | String | 是 | 128 | 中莱开放平台的应用密匙 | ZLGJSCXXXXXXXXXXXXXXXXXX |
express | String | 是 | 32 | 快递编号【顺丰请输入运单号: 收件人或寄件人手机号后四位。例如:123456789:1234】 | 1234567890 |
company | String | 否 | 32 | 快递公司代码,详见附件。不传则自动识别,不过准确性没有传此值高。 | SFEXPRESS |
响应参数
参数 | 类型 | 是否必传 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
code | String | 是 | 4 | 请求状态值 | 0000(其他值为请求失败) |
msg | String | 是 | 128 | 请求状态信息 | success |
ip | String | 是 | 128 | 请求IP | 120.0.0.1 |
state | String | 是 | 128 | 请求数据状态:status 0:正常查询 201:快递单号错误 203:快递公司不存在 204:快递公司识别失败 205:没有信息 207:该单号被限制,错误单号。 | 0(其他值为请求失败) |
time | String | 是 | 128 | 服务器处理时间 | 1509465576 |
data | Array | 是 | -- | 快递物流数据 | array |
data:deliverystatus | String | 是 | 128 | 0:快递收件(揽件)1.在途中 2.正在派件 3.已签收 4.派送失败 5.疑难件 6.退件签收 | 0 |
data:issign | String | 是 | 128 | 是否签收:1是,其他否 | 1 |
data:expName | String | 是 | 128 | 快递公司中文名称 | 顺丰速运 |
data:expSite | String | 是 | 128 | 快递公司官网 | https://open.zldqy.com/docs/t/28.html |
data:expSite | String | 是 | 128 | 快递公司官网 | |
data:expPhone | String | 是 | 128 | 快递公司电话 | 028-67871007 |
data:courier | String | 否 | 128 | 快递公司派送员姓名 | 中莱达 |
data:courierPhone | String | 否 | 128 | 快递公司派送员电话 | 13300000000 |
返回结果说明
字段名 | 类型 | 示例值 | 描述 |
msg | string | ok | 消息 |
result | object | {...} | 结果集 |
issign | string | 1 | 是否本人签收【不准 可能物管帮收】 |
number | string | 454244690951 | 运单编号 |
expName | string | 中通快递 | 快递公司名字 |
deliverystatus | string | 3 | 投递状态 0快递收件(揽件)1.在途中 2.正在派件 3.已签收 4.派送失败 5.疑难件 6.退件签收 |
expSite | string | www.zto.com | 快递公司官网 |
expPhone | string | 95311 | 快递公司电话 |
type | string | zto | 快递公司编码 |
list | array | [...] | 结果集 |
time | string | 2017-09-19 18:01:22 | 时间点 |
status | string | [成都市] [成都华阳]的派件已签收 感谢使用中通快递,期待再次为您服务! | 事件详情 |
快递投递状态码(deliverystatus)
状态码 | 说明 |
0 | 快递收件(揽件) |
1 | 在途中 |
2 | 正在派件 |
3 | 已签收 |
4 | 派送失败(无法联系到收件人或客户要求择日派送,地址不详或手机号不清) |
5 | 疑难件(收件人拒绝签收,地址有误或不能送达派送区域,收费等原因无法正常派送) |
6 | 退件签收 |
status外层返回状态码
状态码 | 说明 |
0 | 查询正常 |
201 | 快递单号错误 |
203 | 快递公司不存在 |
204 | 快递公司识别失败 |
205 | 没有信息;单号错误 (一个单号对应多个快递公司,请求须指定快递公司) |
207 | 该单号被限制,错误单号;一个单号对应多个快递公司,请求须指定快递公司 |
快递公司列表【陆续更新】
快递公司 | type缩写 | 快递公司 | type缩写 |
AAE | AAEWEB | 澳天速运 | AOTSD |
安迅物流 | ANXL | 安鲜达 | EXFRESH |
安捷物流 | AJWL | ANTS | ANTS |
安世通快递 | ASTEXPRESS | 爱拜物流 | IBUY8 |
澳多多国际速递 | ADODOXOM | Aplus物流 | APLUSEX |
安达速递 | ADAPOST | 澳世速递 | AUSEXPRESS |
澳洲迈速快递 | MAXEEDEXPRESS | 昂威物流 | ONWAY |
Aramex | ARAMEX | 能达 | ND56 |
DHL国内件 | DHL | DHL国际件 | DHL_EN |
DPEX | DPEX | 平安快递 | EFSPOST |
D速 | DEXP | 秦远物流 | CHINZ56 |
EMS | EMS | 全晨 | QCKD |
EWE | EWE | 全峰 | QFKD |
FedEx | FEDEX | 全一 | APEX |
FedEx国际 | FEDEXIN | 如风达 | RFD |
PCA | PCA | 三态 | SFC |
TNT | TNT | 申通 | STO |
UPS | UPS | 盛丰 | SFWL |
安捷快递 | ANJELEX | 盛辉 | SHENGHUI |
安能 | ANE | 顺达快递 | SDEX |
安能快递 | ANEEX | 顺丰 | SFEXPRESS |
安信达 | ANXINDA | 苏宁 | SUNING |
百福东方 | EES | 速尔 | SURE |
百世快递 | HTKY | 天地华宇 | HOAU |
百世快运 | BSKY | 天天 | TTKDEX |
程光 | FLYWAYEX | 万庚 | VANGEN |
大田 | DTW | 万家物流 | WANJIA |
德邦 | DEPPON | 万象 | EWINSHINE |
飞洋 | GCE | 文捷航空 | GZWENJIE |
凤凰 | PHOENIXEXP | 新邦 | XBWL |
富腾达 | FTD | 信丰 | XFEXPRESS |
共速达 | GSD | 亚风 | BROADASIA |
国通 | GTO | 宜送 | YIEXPRESS |
黑狗 | BLACKDOG | 易达通 | QEXPRESS |
恒路 | HENGLU | 易通达 | ETD |
鸿远 | HYE | 优速 | UC56 |
华企 | HQKY | 邮政包裹 | CHINAPOST |
急先达 | JOUST | 原飞航 | YFHEX |
加运美 | TMS | 圆通 | YTO |
佳吉 | JIAJI | 源安达 | YADEX |
佳怡 | JIAYI | 远成 | YCGWL |
嘉里物流 | KERRY | 越丰 | YFEXPRESS |
锦程快递 | HREX | 运通 | YTEXPRESS |
晋越 | PEWKEE | 韵达 | YUNDA |
京东 | JD | 宅急送 | ZJS |
京广 | KKE | 芝麻开门 | ZMKMEX |
九曳 | JIUYESCM | 中国东方 | COE |
跨越速运 | KYEXPRESS | 中铁快运 | CRE |
快捷 | FASTEXPRESS | 中铁物流 | ZTKY |
蓝天 | BLUESKY | 中通 | ZTO |
联昊通 | LTS | 龙邦 | LBEX |
中通快运 | ZTO56 | 中邮 | CNPL |
壹米滴答 | YIMIDIDA | 品骏快递 | PJKD |
日日顺物流 | RRS | 汇通快递 | HTKY |
宇鑫物流 | YXWL | 邮政国际包裹 | INTMAIL |
东骏快捷 | DJ56 | 联邦快递 | FEDEX |
联邦快递国际 | FEDEX_GJ | 配思航宇 | PEISI |
澳邮专线(澳邮中国快运) | AYCA | 八达通 | BDT |
城市100 | CITY100 | 城际快递 | CJKD |
递四方速递 | D4PX | 飞康达 | FKD |
广通 | GTSD | 环球速运 | HQSY |
好来运快递 | HYLSD | 捷安达 | JAD |
捷特快递 | JTKD | 景光物流 | JGWL |
民邦快递 | MB | 美快 | MK |
明亮物流 | MLWL | 平安达腾飞快递 | PADTF |
泛捷快递 | PANEX | 全日通快递 | QRT |
全信通 | QXT | 瑞丰速递 | RFEX |
赛澳递 | SAD | 圣安物流 | SAWL |
上大物流 | SDWL | 速通物流 | ST |
速腾快递 | STWL | 速必达物流 | SUBIDA |
万家康 | WJK | 新杰物流 | XJ |
增益快递 | ZENY | 中邮物流 | ZYWL |
河马动力 | HEMA | 澳通速递 | AOL |
民航 | CAE |
评价此篇文档