专注于数据共享与专业API数据接口:快递单号智能识别/快递公司+快递单号查询接口API

1、接口说明

1.1、接口一:快递单号智能识别

快递单号智能识别,是根据查询的快递单号自动智能识别出该运单所属的快递公司,再获取快递公司及实时的运单状态和运单状态等信息。

1.2、接口二:快递公司+快递单号

快递公司+快递单号,是根据查询的快递公司和快递单号,获取快递公司及实时的运单状态和运单状态等信息。

2、接口描述

2.1、功能描述

获取快递公司及实时的运单状态和运单状态等信息。

2.2、URL 示例

2.2.1、接口一:快递单号智能识别

1)http 协议:

POST 方式请求:

http://cha.ebaitian.cn/api/json?appid=xxx&module=getExpressInfo&order=xxx&sign=xxx

GET 方式请求:

http://cha.ebaitian.cn/api/json?type=get&appid=xxx&module=getExpressInfo&order=xxx&sign=xxx

2)https 协议:

POST 方式请求:

https://cha.ebaitian.cn/api/json?appid=xxx&module=getExpressInfo&order=xxx&sign=xxx

GET 方式请求:

https://cha.ebaitian.cn/api/json?type=get&appid=xxx&module=getExpressInfo&order=xxx&sign=xxx

2.2.2、接口二:快递公司+快递单号

1)http 协议:

POST 方式请求:

http://cha.ebaitian.cn/api/json?appid=xxx&module=getExpressInfoNoSmart&company=xxx&order=xxx&sign=xxx

GET 方式请求:

http://cha.ebaitian.cn/api/json?type=get&appid=xxx&module=getExpressInfoNoSmart&company=xxx&order=xxx&sign=xxx

2)https 协议:

POST 方式请求:

https://cha.ebaitian.cn/api/json?appid=xxx&module=getExpressInfoNoSmart&company=xxx&order=xxx&sign=xxx

GET 方式请求:

https://cha.ebaitian.cn/api/json?type=get&appid=xxx&module=getExpressInfoNoSmart&company=xxx&order=xxx&sign=xxx

3、请求参数

3.1、数据包体

3.1.1、接口一:快递单号智能识别

{
    "type": "get",
    "appid": "1000xxxx",
    "module": "getExpressInfo",
    "order": "247198050163",
    "sign": "ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4"
}

3.1.2、接口二:快递公司+快递单号

{
    "type": "get",
    "appid": "1000xxxx",
    "module": "getExpressInfoNoSmart",
    "company": "shunfeng",
    "order": "247198050163",
    "sign": "ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4"
}

3.2、参数说明

3.2.1、接口一:快递单号智能识别

参数 必选 类型 描述
type string 授权接口的请求方式
appid string 授权接口的 AppID,请填写您在我要查官网上申请到的 AppID
module string 目标请求的数据模块,根据快递单号智能查询快递信息为:getExpressInfo
order string 目标要查询的快递单号,支持的快递公司及参数对照见下面的其他说明
sign string 请求凭证,具体计算方式见下面的其他说明

3.2.2、接口二:快递公司+快递单号

参数 必选 类型 描述
type string 授权接口的请求方式
appid string 授权接口的 AppID,请填写您在我要查官网上申请到的 AppID
module string 目标请求的数据模块,根据快递公司和快递单号查询快递信息为:getExpressInfoNoSmart
company string 目标要查询的快递公司,支持的快递公司及参数对照见下面的快递公司代码,代码或扩展代码均可
order string 目标要查询的快递单号,支持的快递公司及参数对照见下面的快递公司代码
sign string 请求凭证,具体计算方式见下面的其他说明

3.3、快递公司代码

支持的快递公司代码及参数对照如下表:

序号 快递公司代码 扩展代码 快递公司
1 360zebra ZY_BM 斑马物联网(360zebra)
2 8europe ZY_BOZ 败欧洲(8europe)
3 aae AAE AAE快递
4 acscourier ACS ACS Courier
5 afghan_post IAFHYZ 阿富汗邮政(Afghan Post)
6 aj AJ 安捷快递
7 al8856 ALKJWL 阿里电商物流(Ali Business Logistics)
8 aland_post IALQDYZ 奥兰群岛芬兰邮政(aland Post)
9 an_post IE 爱尔兰邮政(An Post)
10 anwl ANE 安能物流
11 aramex ARAMEX Aramex
12 armenia_post IYMNYYZ 亚美尼亚邮政(Armenia Post)
13 aruba_post IALBYZ 阿鲁巴邮政(Aruba Post)
14 auexpress AYCA 澳邮中国快运(Auexpress)
15 aus ZY_AUSE 澳世速递(Ausworld Express)
16 australia_post IADLYYZ 澳大利亚邮政(Australia Post)
17 austria_post AT 奥地利邮政(Austrian Post)
18 azerbaijan_post IASBJYZ 阿塞拜疆邮政(Azerbaijan Post)
19 bahrain-post IBLYZ 巴林邮政(Bahrain Post)
20 bangladesh_ems IMJLGEMS 孟加拉国 EMS(Bangladesh EMS)
21 beihaiguoji BHGJ 贝海国际速递
22 belgium_post BEL 比利时邮政(Bpost)
23 belpochta IBELSYZ 白俄罗斯邮政(Belarus Post)
24 bermuda_post IBMDYZ 百慕大邮政(Bermuda Post)
25 huitong HTKY 百世汇通快递
26 bfdf BFDF 百福东方
27 bhutan_post BUDANYOUZH 不丹邮政(Bhutan Post)
28 bosnia_and_herzegovina_post IBHYZ 波黑邮政(Bosnia And Herzegovina Post)
29 botswana_post IBCWNYZ 博茨瓦纳邮政(Botswana Post)
30 brazil_correios BR 巴西邮政(Brazil Correios)
31 brunei_post IWLYZ 文莱邮政(Brunei Post)
32 bulgaria_post IBJLYYZ 保加利亚邮政(Bulgaria Post)
33 cambodia_post IJPZYZ 柬埔寨邮政(Cambodia Post)
34 canada_post CA 加拿大邮政(Canada Post)
35 cdek CDEK CDEK快递
36 chengguang CG 程光快递
37 chengji CJKD 城际快递
38 chinz56 QYHY 秦远物流
39 chukou1 CKY 出口易物流
40 colombia_post IGLBYYZ 哥伦比亚邮政(Colombia Post)
41 correo_argentino IAGTYZ 阿根廷邮政(Argentino Post)
42 correos_chile IZLYZ 智利邮政(Correos Chile)
43 correos_mexico IMXGYZ 墨西哥邮政(Mexico Post)
44 correos_spain IXBYYZ 西班牙邮政(Correos)
45 cs CITY100 城市100快递
46 cxwl CXHY 传喜物流
47 czech_post IJKYZ 捷克邮政
48 dadaowuliu DDWL 大道物流
49 debang DBL 德邦物流
50 dhl DHL DHL快递
51 dpe_express DBYWL 递必易
52 ds DSWL D速快递
53 dsf D4PX 递四方速递
54 dtwl DTWL 大田物流
55 ems EMS EMS快递
56 ewe EWE ewe快递
57 fanyu FYKD 凡宇快递
58 fastgo FASTGO 速派快递FastGo(Fastgo)
59 fedexcn FEDEX FEDEX国内快递
60 feiyang ZY_FY 飞洋快递
61 fkd FKD 飞康达快递
62 flytexpress IFTWL 飞特物流(Flyt Express)
63 ftd FTD 富腾达快递
64 gdems GDEMS 广东ems快递
65 gsdwl GSD 共速达物流
66 gtsd GTSD 高铁速递
67 guada GD 冠达快递
68 guangtong GTONG 广通速递
69 guotong GTO 国通快递
70 henglu HLWL 恒路物流
71 hhexp HHWL 华翰物流
72 hong_kong_post XGYZ 香港邮政(Hong Kong Post)
73 huaqi HQKD 华企快递
74 huiqiang ZHQKD 汇强快递
75 hxlwl HXLWL 华夏龙物流
76 japan_post JP 日本邮政(Japan Post)
77 jiayunmei JYM 加运美快递
78 jiete JTKD 捷特快递
79 jingdong JD 京东快递
80 jingguang JGSD 京广快递
81 jinyue JYKD 晋越快递
82 jldt JLDT 嘉里大通物流
83 jywl JYWL 佳怡物流
84 korea_post IHGYZ 韩国邮政(Korea Post)
85 kuaijie FAST 快捷快递
86 kysy KYSY 跨越速运
87 lianhaotong LHT 联昊通快递
88 lijisong LJSKD 立即送
89 longbang LB 龙邦快递
90 minbang MB 民邦快递
91 minhang MHKD 民航快递
92 ocs OCS OCS快递
93 pakistan_post IBJSTYZ 巴基斯坦邮政(Pakistan Post)
94 parcel_force IYGYZ 英国邮政(Parcel Force)
95 pinganda PADTF 平安达快递
96 pinjun PJ 品骏快递
97 qichen VENUCIA 启辰国际物流(venucia)
98 quanchen QCKD 全晨快递
99 quanfeng QFKD 全峰快递
100 quanritong QRT 全日通快递
101 quanyi UAPEX 全一快递
102 rrs RRS 日日顺物流
103 rufengda RFD 如风达快递
104 saiaodi SAD 赛澳递
105 shengan SAWL 圣安物流
106 shengfeng SFWL 盛丰物流
107 shenghui SHWL 盛辉物流
108 shentong STO 申通快递
109 shunfeng SF 顺丰快递
110 stwl ST 速通物流
111 suer SURE 速尔快递
112 suning SNWL 苏宁快递
113 suteng STWL 速腾快递
114 tdhy HOAU 天地华宇
115 tiantian HHTT 天天快递
116 tnt TNT TNT快递
117 ubonex UBONEX 优邦速运
118 ups UPS UPS国际快递
119 weitepai WTP 微特派快递
120 wxwl WXWL 万象物流
121 xdexpress XD 迅达速递
122 xfwl XFEX 信丰物流
123 xinbang XBWL 新邦物流
124 xinjie XJ 新杰物流
125 yad YADEX 源安达快递
126 yafeng YFSD 亚风快递
127 ycky YCWL 远成快运
128 ycwl YCWL 远成物流
129 yitongda IYTG 易通达
130 ymdd YMDD 壹米滴答物流
131 yousu UC 优速快递
132 yuanfeihang YFHEX 原飞航快递
133 yuantong YTO 圆通快递
134 yuefeng YFEX 越丰快递
135 yunda YD 韵达快递
136 bgpyghx YZPY 邮政包裹、平邮、挂号信
137 zengyi ZENY 增益快递
138 zhongtie ZTKY 中铁快运
139 zhongtong ZTO 中通快递
140 zhongyou CNPEX 中邮物流
141 zjs ZJS 宅急送快递

3.4、其他说明

1)type:可选值 get,如果赋值 get,则以 get 方式提交数据;默认以 post 方式提交数据;

2)sign:签名校验

当 module 赋值 getExpressInfo 时,根据公式$sign=sha256(appid=$appid&module=getExpressInfo&order=$order&appkey=$appkey)生成;

当 module 赋值 getExpressInfoNoSmart 时,根据公式$sign=sha256(appid=$appid&module=getExpressInfoNoSmart&company=$company&order=$order&appkey=$appkey)生成;

其中:appkey 为授权接口的 AppKey,请填写您在我要查官网上申请到的 AppKey 。

3)company:快递公司,赋值快递公司代码或扩展代码均可。

3.5、构造伪代码如下

3.5.1、接口一:快递单号智能识别

string type = "get"; //请求方式,可以赋值为:post
string appid = "1000xxxx"; //sdkappid 对应的 appid,需要业务方高度保密
string module = "getExpressInfo"; //请求的数据模块,此处赋值:getExpressInfo
string order = "247198050163"; //要查询的快递单号
string sign = sha256(appid=1000xxxx&module=getExpressInfo&order=247198050163&appkey=56cf61af4b7897e704f67deb88ae8f24);

3.5.2、接口二:快递公司+快递单号

string type = "get"; //请求方式,可以赋值为:post
string appid = "1000xxxx"; //sdkappid 对应的 appid,需要业务方高度保密
string module = "getExpressInfoNoSmart"; //请求的数据模块,此处赋值:getExpressInfoNoSmart
string company = "shunfeng"; //要查询的快递公司
string order = "247198050163"; //要查询的快递单号
string sign = sha256(appid=1000xxxx&module=getExpressInfoNoSmart&company=shunfeng&order=247198050163&appkey=56cf61af4b7897e704f67deb88ae8f24);

4、响应参数

4.1、数据包体

{
    "result":1,
    "description":"TRUE",
    "flag":"",
    "expressInfo":{
        "id":"shunfeng",
        "name":"顺丰快递",
        "order":"247198050163",
        "message":"",
        "errcode":"0000",
        "status":4,
        "data":[
            {
                "time":"2018-06-06 17:20:22",
                "content":"顺丰速运 已收取快件"
            },
            {
                "time":"2018-06-06 19:37:16",
                "content":"快件在【武汉硚口区硚口营业点】已装车,准备发往 【武汉走马岭集散中心】"
            },
            {
                "time":"2018-06-06 19:47:53",
                "content":"快件已发车"
            },
            {
                "time":"2018-06-06 20:51:13",
                "content":"快件到达 【武汉走马岭集散中心】"
            },
            {
                "time":"2018-06-06 20:53:46",
                "content":"快件在【武汉走马岭集散中心】已装车,准备发往下一站"
            },
            {
                "time":"2018-06-06 21:26:00",
                "content":"快件已发车"
            },
            {
                "time":"2018-06-06 22:17:29",
                "content":"快件到达 【武汉总集散中心】"
            },
            {
                "time":"2018-06-07 00:08:13",
                "content":"快件在【武汉总集散中心】已装车,准备发往下一站"
            },
            {
                "time":"2018-06-07 03:16:03",

               "content":"快件到达 【杭州总集散中心】"
            },
            {
                "time":"2018-06-07 05:45:20",
                "content":"快件在【杭州总集散中心】已装车,准备发往下一站"
            },
            {
                "time":"2018-06-07 08:57:00",
                "content":"快件到达 【福州总集散中心】"
            },
            {
                "time":"2018-06-07 08:57:30",
                "content":"快件在【福州总集散中心】已装车,准备发往 【福州尚干集散中心】"
            },
            {
                "time":"2018-06-07 09:30:24",
                "content":"快件已发车"
            },
            {
                "time":"2018-06-07 10:31:35",
                "content":"快件到达 【福州尚干集散中心】"
            },
            {
                "time":"2018-06-07 11:16:19",
                "content":"快件在【福州尚干集散中心】已装车,准备发往 【泉州晋江集散中心】"
            },
            {
                "time":"2018-06-07 12:17:36",
                "content":"快件已发车"
            },
            {
                "time":"2018-06-07 15:26:19",
                "content":"快件到达 【泉州晋江集散中心】"
            },
            {
                "time":"2018-06-07 15:52:54",
                "content":"快件在【泉州晋江集散中心】已装车,准备发往下一站"
            },
            {
                "time":"2018-06-07 17:16:21",
                "content":"快件已发车"
            },
            {
                "time":"2018-06-07 17:52:49",
                "content":"快件到达 【泉州丰泽招丰村路营业点】"
            },
            {
                "time":"2018-06-08 08:23:14",
                "content":"快件交给周松寿,正在派送途中(联系电话:15906062987)"
            },
            {
                "time":"2018-06-08 09:38:23",
                "content":"快件派送至【丰巢智能快递柜】,请您凭取件码至电力职业技术学院原二号教学楼旁车库领取您的快递."
            },
            {
                "time":"2018-06-08 15:38:40",
                "content":"已签收(丰巢签收),感谢使用顺丰,期待再次为您服务"
            }
        ]
    }
}

4.2、参数说明

参数 必选 类型 描述
result string 接口响应结果:0-失败;1-成功
description string 接口响应描述:一般为 TURE(result=1) 与 FALSE(result=0),或者返回错误信息
flag string 错误说明,没有错误则返回空
expressInfo object 返回手机号码归属地信息

expressInfo 参数说明:

参数 必选 类型 描述
id string 快递公司代码,如:顺丰-shunfeng、申通-shentong,具体请查看上面的快递公司代码
name string 快递公司名称
order string 快递单号,请注意区分大小写
message string 输出消息内容(可忽略),一般返回空
errcode string 返回错误码:
0-无错误;
1-快递KEY无效;
2-快递代号无效;
3-访问次数达到最大额度;
4-查询服务器返回错误即返回状态码非200;
5-程序执行出错
status string 订单跟踪状态:
0-查询出错(即errCode!=0);
1-暂无记录;
2-在途中;
3-派送中;
4-已签收;
5-拒收;
6-疑难件;
7-退回
data object 运单跟踪数据集合

data 参数说明:

参数 必选 类型 描述
time string 运单时间节点
content string 运单时间节点对应的状态
点赞 0 分享
本文为「本站原创」,未经我们许可,严谨任何人或单位以任何形式转载或刊载本文章,我们保留依法追究侵权的权力!

微信联系我们

湖北亿百天信息技术有限公司客户服务

使用微信扫一扫

昵称:客户服务

公司:湖北亿百天信息技术有限公司

电话:027-88773336

手机:15342213852

邮箱:serviceebaitian.cn

相关栏目

加载中...

成为会员立享特权

立即注册亿百天公司会员,在线联系客服立即享受会员特权,还有丰厚礼品赠送;签约时可以享受特低折扣优惠,期待您的加入!

客服热线:400-840-3336

我们为您提供个性化的售前咨询服务,及全面的技术售后服务。