快递查询

国内第一个完整提供 Demo 代码示例及数据专业且全面的 API 查询接口。
打造精品数据 API 品质,腾讯云提供计算服务及亿百天提供技术支持。
注册本站会员,即可免费使用!

快递查询

接口使用

我要查询

提示:请在下面的 Demo 中输入您要查询的数据,点击查询即可。

快递查询(接口一:快递单号智能识别)



快递查询(接口二:快递公司+快递单号)


查询说明

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

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

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

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

接口描述

功能描述

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

URL 示例

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

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

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

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

请求参数

数据包体

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

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

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

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

参数说明

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

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

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

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

快递公司代码

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

序号 快递公司代码 扩展代码 快递公司
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 宅急送快递

其他说明

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:快递公司,赋值快递公司代码或扩展代码均可。

构造伪代码如下:

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

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);

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

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);

响应参数

数据包体

{
    "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":"已签收(丰巢签收),感谢使用顺丰,期待再次为您服务"
            }
        ]
    }
}

参数说明

参数 必选 类型 描述
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 运单时间节点对应的状态

SDK 及代码示例

PHP SDK

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

方法一:以 POST 方式请求数据

//接口参数
$api_url='http://cha.ebaitian.cn/api/json';
$api_appid='1000xxxx';
$api_appkey='56cf61af4b7897e704f67deb88ae8f24';

//函数,以POST方式提交数据,PHP需要开启CURL函数;数据传输安全,建议使用
function getExpressInfo($order){
    global $api_url,$api_appid,$api_appkey;
    $posturl=$api_url;
    $data='appid='.$api_appid.'&module=getExpressInfo&order='.$order;
    $sign=hash("sha256",$data.'&appkey='.$api_appkey);
    $postdata=array("appid"=>$api_appid,"appkey"=>$api_appkey,"module"=>"getExpressInfo","order"=>$order,'sign'=>$sign);
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $posturl);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postdata);
    $output = curl_exec($curl);
    curl_close($curl);
    $obj=json_decode($output);
    $result=$obj->result;
    if($result==1){
        $value=$obj->expressInfo->name;
        $value.=','.$obj->expressInfo->order;
        $value.=','.$obj->expressInfo->status;
    }else{
        $value=$obj->flag;
    }
    return $value;
}
//调用函数
$order='247198050163';
echo getExpressInfo($order);
exit;

方法二:以 GET 方式请求数据

//接口参数
$api_url='http://cha.ebaitian.cn/api/json';
$api_appid='1000xxxx';
$api_appkey='56cf61af4b7897e704f67deb88ae8f24';

//函数,以GET方式提交数据
function getExpressInfo($order){
    global $api_url,$api_appid,$api_appkey;
    $data='appid='.$api_appid.'&module=getExpressInfo&order='.$order;
    $sign=hash("sha256",$data.'&appkey='.$api_appkey);
    $info_get=file_get_contents($api_url.'?type=get&'.$data.'&sign='.$sign);
    $info_json=json_decode($info_get, true);
    $result=$info_json['result'];
    if($result==1){
        $value=$info_json['expressInfo']['name'];
        $value.=','.$info_json['expressInfo']['order'];
        $value.=','.$info_json['expressInfo']['status'];
    }else{
        $value=$info_json['flag'];
    }
    return $value;
}
//调用函数
$order='247198050163';
echo getExpressInfo($order);
exit;

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

方法一:以 POST 方式请求数据

//接口参数
$api_url='http://cha.ebaitian.cn/api/json';
$api_appid='1000xxxx';
$api_appkey='56cf61af4b7897e704f67deb88ae8f24';

//函数,以POST方式提交数据,PHP需要开启CURL函数;数据传输安全,建议使用
function getExpressInfo($company,$order){
    global $api_url,$api_appid,$api_appkey;
    $posturl=$api_url;
    $data='appid='.$api_appid.'&module=getExpressInfoNoSmart&company=company&order='.$order;
    $sign=hash("sha256",$data.'&appkey='.$api_appkey);
    $postdata=array("appid"=>$api_appid,"appkey"=>$api_appkey,"module"=>"getExpressInfoNoSmart","company"=>$company,"order"=>$order,'sign'=>$sign);
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $posturl);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postdata);
    $output = curl_exec($curl);
    curl_close($curl);
    $obj=json_decode($output);
    $result=$obj->result;
    if($result==1){
        $value=$obj->expressInfo->name;
        $value.=','.$obj->expressInfo->order;
        $value.=','.$obj->expressInfo->status;
    }else{
        $value=$obj->flag;
    }
    return $value;
}
//调用函数
$order='247198050163';
echo getExpressInfo($order);
exit;

方法二:以 GET 方式请求数据

//接口参数
$api_url='http://cha.ebaitian.cn/api/json';
$api_appid='1000xxxx';
$api_appkey='56cf61af4b7897e704f67deb88ae8f24';

//函数,以GET方式提交数据
function getExpressInfo($company,$order){
    global $api_url,$api_appid,$api_appkey;
    $data='appid='.$api_appid.'&module=getExpressInfoNoSmart&company=$company&order='.$order;
    $sign=hash("sha256",$data.'&appkey='.$api_appkey);
    $info_get=file_get_contents($api_url.'?type=get&'.$data.'&sign='.$sign);
    $info_json=json_decode($info_get, true);
    $result=$info_json['result'];
    if($result==1){
        $value=$info_json['expressInfo']['name'];
        $value.=','.$info_json['expressInfo']['order'];
        $value.=','.$info_json['expressInfo']['status'];
    }else{
        $value=$info_json['flag'];
    }
    return $value;
}
//调用函数
$order='247198050163';
echo getExpressInfo($company,$order);
exit;

Java SDK

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

//以下示例是以 GET 方式请求数据
public class QueryHelper {
	
    public static String apiurl="http://cha.ebaitian.cn/api/json";
    public static String appid="1000xxxx";
    public static String appkey="56cf61af4b7897e704f67deb88ae8f24";
    public static String module="getExpressInfo";
    
    public static String getSHA256Str(String str){
        MessageDigest messageDigest;
        String encdeStr = "";
        try {
            messageDigest = MessageDigest.getInstance("SHA-256");
            byte[] hash = messageDigest.digest(str.getBytes("UTF-8"));
            encdeStr = Hex.encodeHexString(hash);
        } catch (NoSuchAlgorithmException e) {
            e.printStackTrace();
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
        return encdeStr;
    }
    
    public static String get(String urlString) {
        try {
            URL url = new URL(urlString);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setConnectTimeout(5 * 1000);
            conn.setReadTimeout(5 * 1000);
            conn.setDoInput(true);
            conn.setDoOutput(true);
            conn.setUseCaches(false);
            conn.setInstanceFollowRedirects(false);
            conn.setRequestMethod("GET"); 
            int responseCode = conn.getResponseCode();
            if (responseCode == 200) {
                StringBuilder builder = new StringBuilder();
                BufferedReader br = new BufferedReader(
                        new InputStreamReader(conn.getInputStream(),"utf-8"));
                for (String s = br.readLine(); s != null; s = br.readLine()) {
                    builder.append(s);
                }
                br.close();
                return builder.toString();
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
        return null;
    }
    
    public static String queryExpress(String order){
        String sign=getSHA256Str("appid="+appid+"&module="+module+"&order="+order+"&appkey="+appkey);
        String url=apiurl+"?type=get&appid="+appid+"&module="+module+"&order="+order+"&sign="+sign;
        return get(url);
    }
}

//使用示例
QueryHelper.queryExpress("247198050163");

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

//以下示例是以 GET 方式请求数据
public class QueryHelper {
	
    public static String apiurl="http://cha.ebaitian.cn/api/json";
    public static String appid="1000xxxx";
    public static String appkey="56cf61af4b7897e704f67deb88ae8f24";
    public static String module="getExpressInfoNoSmart";
    
    public static String getSHA256Str(String str){
        MessageDigest messageDigest;
        String encdeStr = "";
        try {
            messageDigest = MessageDigest.getInstance("SHA-256");
            byte[] hash = messageDigest.digest(str.getBytes("UTF-8"));
            encdeStr = Hex.encodeHexString(hash);
        } catch (NoSuchAlgorithmException e) {
            e.printStackTrace();
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
        return encdeStr;
    }
    
    public static String get(String urlString) {
        try {
            URL url = new URL(urlString);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setConnectTimeout(5 * 1000);
            conn.setReadTimeout(5 * 1000);
            conn.setDoInput(true);
            conn.setDoOutput(true);
            conn.setUseCaches(false);
            conn.setInstanceFollowRedirects(false);
            conn.setRequestMethod("GET"); 
            int responseCode = conn.getResponseCode();
            if (responseCode == 200) {
                StringBuilder builder = new StringBuilder();
                BufferedReader br = new BufferedReader(
                        new InputStreamReader(conn.getInputStream(),"utf-8"));
                for (String s = br.readLine(); s != null; s = br.readLine()) {
                    builder.append(s);
                }
                br.close();
                return builder.toString();
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
        return null;
    }
    
    public static String queryExpress(String company, String order){
        String sign=getSHA256Str("appid="+appid+"&module="+module+"&company="+company+"&order="+order+"&appkey="+appkey);
        String url=apiurl+"?type=get&appid="+appid+"&module="+module+"&company="+company+"&order="+order+"&sign="+sign;
        return get(url);
    }
}

//使用示例
QueryHelper.queryExpress("shunfeng", "247198050163");

Python SDK

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

#!/usr/bin/python
# -*- coding: utf-8 -*-
import httplib2
import hashlib
from urllib.parse import urlencode #python3
#from urllib import urlencode #python2

apiurl='http://cha.ebaitian.cn/api/json'
appid='1000xxxx'
appkey='56cf61af4b7897e704f67deb88ae8f24'
module='getExpressInfo'
order='247198050163'
data='appid='+appid+'&module='+module+'&order='+order
sign_data=data+'&appkey='+appkey

# from Crypto.Cipher import AES
# from Crypto.Hash import SHA256
# 256
hash_256 = hashlib.sha256()
hash_256.update(sign_data.encode('utf-8'))
sign = hash_256.hexdigest()

postdata = urlencode({'appid':appid,'module':module,'order':order,'sign':sign})
url = apiurl+'?'+postdata
http = httplib2.Http()
response, content = http.request(url,'GET')
print(content.decode("utf-8"))

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

#!/usr/bin/python
# -*- coding: utf-8 -*-
import httplib2
import hashlib
from urllib.parse import urlencode #python3
#from urllib import urlencode #python2

apiurl='http://cha.ebaitian.cn/api/json'
appid='1000xxxx'
appkey='56cf61af4b7897e704f67deb88ae8f24'
module='getExpressInfoNoSmart'
company='shunfeng'
order='247198050163'
data='appid='+appid+'&module='+module+'&company='+company+'&order='+order
sign_data=data+'&appkey='+appkey

# from Crypto.Cipher import AES
# from Crypto.Hash import SHA256
# 256
hash_256 = hashlib.sha256()
hash_256.update(sign_data.encode('utf-8'))
sign = hash_256.hexdigest()

postdata = urlencode({'appid':appid,'module':module,'company':company,'order':order,'sign':sign})
url = apiurl+'?'+postdata
http = httplib2.Http()
response, content = http.request(url,'GET')
print(content.decode("utf-8"))

Node.js SDK

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

方法一:以 POST 方式请求数据

//以 POST 方式提交
var http = require('http');  

var querystring = require('querystring');  

//参数设置
var appid = '1000xxxx';
var appkey = '56cf61af4b7897e704f67deb88ae8f24';
var module = 'getExpressInfo';

//目标查询快递单号
var order='247198050163';

//签名,SHA256 不可直接调用;函数参考下载地址:https://github.com/alexweber/jquery.sha256
var sign = SHA256('appid='+appid+'&module='+module+'&order='+order+'&appkey='+appkey);

//这是需要提交的数据
var post_data = {
    appid: appid,  
    module: module,
    order: order,
    sign: sign
};  

var content = querystring.stringify(post_data);  

var options = {  
    hostname: 'cha.ebaitian.cn',  
    port: 80,  
    path: '/api/json',  
    method: 'POST',  
    headers: {  
        'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8'  
    }  
};  

var req = http.request(options, function (res) {  
    console.log('STATUS: ' + res.statusCode);  
    console.log('HEADERS: ' + JSON.stringify(res.headers));  
    res.setEncoding('utf8');  
    res.on('data', function (chunk) {  
        console.log('BODY: ' + chunk);  
    //JSON.parse(chunk)
    });  
});  

req.on('error', function (e) {  
    console.log('problem with request: ' + e.message);  
});  

// write data to request body  
req.write(content);  

req.end(); 

方法二:以 GET 方式请求数据

//以 GET 方式提交
var http = require('http');  

var querystring = require('querystring');  

//参数设置
var appid = '1000xxxx';
var appkey = '56cf61af4b7897e704f67deb88ae8f24';
var module = 'getExpressInfo';

//目标查询快递单号
var order='247198050163';

//签名,SHA256 不可直接调用;函数参考下载地址:https://github.com/alexweber/jquery.sha256
var sign = SHA256('appid='+appid+'&module='+module+'&order='+order+'&appkey='+appkey);

//这是需要提交的数据
var data = {
    appid: appid, 
    module: module,
    order: order,
    sign: sign
};

var content = querystring.stringify(data);  

var options = {  
    hostname: 'cha.ebaitian.cn',  
    port: 80,  
    path: '/api/json?' + content,  
    method: 'GET'  
};  

var req = http.request(options, function (res) {  
    console.log('STATUS: ' + res.statusCode);  
    console.log('HEADERS: ' + JSON.stringify(res.headers));  
    res.setEncoding('utf8');  
    res.on('data', function (chunk) {  
        console.log('BODY: ' + chunk);
    });  
});  

req.on('error', function (e) {  
    console.log('problem with request: ' + e.message);  
});  

req.end(); 

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

方法一:以 POST 方式请求数据

//以 POST 方式提交
var http = require('http');  

var querystring = require('querystring');  

//参数设置
var appid = '1000xxxx';
var appkey = '56cf61af4b7897e704f67deb88ae8f24';
var module = 'getExpressInfoNoSmart';

//目标查询快递公司及快递单号
var company='shunfeng';
var order='247198050163';

//签名,SHA256 不可直接调用;函数参考下载地址:https://github.com/alexweber/jquery.sha256
var sign = SHA256('appid='+appid+'&module='+module+'&company='+company+'&order='+order+'&appkey='+appkey);

//这是需要提交的数据
var post_data = {
    appid: appid,  
    module: module,
    company: company,
    order: order,
    sign: sign
};  

var content = querystring.stringify(post_data);  

var options = {  
    hostname: 'cha.ebaitian.cn',  
    port: 80,  
    path: '/api/json',  
    method: 'POST',  
    headers: {  
        'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8'  
    }  
};  

var req = http.request(options, function (res) {  
    console.log('STATUS: ' + res.statusCode);  
    console.log('HEADERS: ' + JSON.stringify(res.headers));  
    res.setEncoding('utf8');  
    res.on('data', function (chunk) {  
        console.log('BODY: ' + chunk);  
    //JSON.parse(chunk)
    });  
});  

req.on('error', function (e) {  
    console.log('problem with request: ' + e.message);  
});  

// write data to request body  
req.write(content);  

req.end(); 

方法二:以 GET 方式请求数据

//以 GET 方式提交
var http = require('http');  

var querystring = require('querystring');  

//参数设置
var appid = '1000xxxx';
var appkey = '56cf61af4b7897e704f67deb88ae8f24';
var module = 'getExpressInfoNoSmart';

//目标查询快递公司及快递单号
var company='shunfeng';
var order='247198050163';

//签名,SHA256 不可直接调用;函数参考下载地址:https://github.com/alexweber/jquery.sha256
var sign = SHA256('appid='+appid+'&module='+module+'&company='+company+'&order='+order+'&appkey='+appkey);

//这是需要提交的数据
var data = {
    appid: appid, 
    module: module,
    company: company,
    order: order,
    sign: sign
};

var content = querystring.stringify(data);  

var options = {  
    hostname: 'cha.ebaitian.cn',  
    port: 80,  
    path: '/api/json?' + content,  
    method: 'GET'  
};  

var req = http.request(options, function (res) {  
    console.log('STATUS: ' + res.statusCode);  
    console.log('HEADERS: ' + JSON.stringify(res.headers));  
    res.setEncoding('utf8');  
    res.on('data', function (chunk) {  
        console.log('BODY: ' + chunk);
    });  
});  

req.on('error', function (e) {  
    console.log('problem with request: ' + e.message);  
});  

req.end(); 

C# SDK

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

using System;
using System.Collections.Generic;
using System.Web;
using System.Net;
using System.Text;

public class getMobileInfo{
    public static string getInfo(string appid, string appkey, string module, string order){
        string url = string.Format("http://cha.ebaitian.cn/api/json?type=get&appid={0}&module={1}&order={2}&sgin={3}", appid, module, order, sgin);
        using (WebClient client = new WebClient()){
            client.Encoding = Encoding.UTF8;
            return client.DownloadString(url);
        }
    }
}

string expressInfo = getMobileInfo.getInfo("1000xxxx", "getExpressInfo", "247198050163", "ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4", Request.UserHostAddress);
Console.WriteLine(expressInfo);
Response.Write(expressInfo);

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

using System;
using System.Collections.Generic;
using System.Web;
using System.Net;
using System.Text;

public class getMobileInfo{
    public static string getInfo(string appid, string appkey, string module, string company, string order){
        string url = string.Format("http://cha.ebaitian.cn/api/json?type=get&appid={0}&module={1}&company={2}&order={3}&sgin={4}", appid, module, company, order, sgin);
        using (WebClient client = new WebClient()){
            client.Encoding = Encoding.UTF8;
            return client.DownloadString(url);
        }
    }
}

string expressInfo = getMobileInfo.getInfo("1000xxxx", "getExpressInfoNoSmart", "shunfeng", "247198050163", "ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4", Request.UserHostAddress);
Console.WriteLine(expressInfo);
Response.Write(expressInfo);

JavaScript SDK

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

方法一:以 POST 方式请求数据

//使用 JQuery 请先加载最新的 JQuery 插件
//参数设置
var apiurl = 'http://cha.ebaitian.cn/api/json';
var appid = '1000xxxx';
var appkey = '56cf61af4b7897e704f67deb88ae8f24';
var module = 'getExpressInfo';

//目标查询快递单号
var order='247198050163';

//签名,SHA256 不可直接调用;函数参考下载地址:https://github.com/alexweber/jquery.sha256
var sign = SHA256('appid='+appid+'&module='+module+'&order='+order+'&appkey='+appkey);

//提交数据
$.ajax({
    url:apiurl,
    type:'post',
    dataType:'json',
    data:{
        appid:appid,
        module:module,
        order:order,
        sign:sign
    },
    success:function(res){
        console.log(res);
    }
});

方法二:以 GET 方式请求数据

//使用 JQuery 请先加载最新的 JQuery 插件
//参数设置
var apiurl = 'http://cha.ebaitian.cn/api/json';
var appid = '1000xxxx';
var appkey = '56cf61af4b7897e704f67deb88ae8f24';
var module = 'getExpressInfo';

//目标查询快递单号
var order='247198050163';

//签名,SHA256 不可直接调用;函数参考下载地址:https://github.com/alexweber/jquery.sha256
var sign = SHA256('appid='+appid+'&module='+module+'&order='+order+'&appkey='+appkey);

//提交数据
$.ajax({
    url:apiurl,
    type:'post',
    dataType:'json',
    data:{
        appid:appid,
        module:module,
        order:order,
        sign:sign
    },
    success:function(res){
        console.log(res);
    }
});

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

方法一:以 POST 方式请求数据

//使用 JQuery 请先加载最新的 JQuery 插件
//参数设置
var apiurl = 'http://cha.ebaitian.cn/api/json';
var appid = '1000xxxx';
var appkey = '56cf61af4b7897e704f67deb88ae8f24';
var module = 'getExpressInfoNoSmart';

//目标查询快递公司及快递单号
var company='shunfeng';
var order='247198050163';

//签名,SHA256 不可直接调用;函数参考下载地址:https://github.com/alexweber/jquery.sha256
var sign = SHA256('appid='+appid+'&module='+module+'&company='+company+'&order='+order+'&appkey='+appkey);

//提交数据
$.ajax({
    url:apiurl,
    type:'post',
    dataType:'json',
    data:{
        appid:appid,
        module:module,
        company:company,
        order:order,
        sign:sign
    },
    success:function(res){
        console.log(res);
    }
});

方法二:以 GET 方式请求数据

//使用 JQuery 请先加载最新的 JQuery 插件
//参数设置
var apiurl = 'http://cha.ebaitian.cn/api/json';
var appid = '1000xxxx';
var appkey = '56cf61af4b7897e704f67deb88ae8f24';
var module = 'getExpressInfoNoSmart';

//目标查询快递公司及快递单号
var company='shunfeng';
var order='247198050163';

//签名,SHA256 不可直接调用;函数参考下载地址:https://github.com/alexweber/jquery.sha256
var sign = SHA256('appid='+appid+'&module='+module+'&company='+company+'&order='+order+'&appkey='+appkey);

//提交数据
$.ajax({
    url:apiurl,
    type:'post',
    dataType:'json',
    data:{
        appid:appid,
        module:module,
        company:company,
        order:order,
        sign:sign
    },
    success:function(res){
        console.log(res);
    }
});

ASP SDK

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

'设置参数
dim apiurl, appid, appkey, module, order, sign
apiurl="http://cha.ebaitian.cn/api/json"
appid="1000xxxx'
appkey="56cf61af4b7897e704f67deb88ae8f24"
module="getExpressInfo"
order="247198050163"

'签名,SHA256 不可直接调用;函数参考地址:https://blog.csdn.net/yesoce/article/details/128546
sgin=SHA256("appid=&appid&"&module="&module&"&order="&order&"&appkey="&appkey)

'异步提交数据
function PostHTTPPage(url,data)
    dim Http 
    set Http=server.createobject("MSXML2.SERVERXMLHTTP.3.0")
    Http.open "POST",url,false
    Http.setRequestHeader "Content-Type", "application/x-www-form-urlencoded"
    Http.send(data) 
    if Http.readystate<>4 then 
    exit function 
    End if
    PostHTTPPage=bytesToBSTR(Http.responseBody,"UTF-8")
    set http=nothing 
    if err.number<>0 then err.Clear 
End function

'提交数据
dim postdata, strTest
postdata="appid=&appid&"&module="&module&"&order="&order&"&sign="&sign
strTest=PostHTTPPage(apiurl,postdata)

'返回结果
response.write(strTest)
response.end

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

'设置参数
dim apiurl, appid, appkey, module, company, order, sign
apiurl="http://cha.ebaitian.cn/api/json"
appid="1000xxxx'
appkey="56cf61af4b7897e704f67deb88ae8f24"
module="getExpressInfoNoSmart"
company="shunfeng"
order="247198050163"

'签名,SHA256 不可直接调用;函数参考地址:https://blog.csdn.net/yesoce/article/details/128546
sgin=SHA256("appid=&appid&"&module="&module&"&company="&company&"&order="&order&"&appkey="&appkey)

'异步提交数据
function PostHTTPPage(url,data)
    dim Http 
    set Http=server.createobject("MSXML2.SERVERXMLHTTP.3.0")
    Http.open "POST",url,false
    Http.setRequestHeader "Content-Type", "application/x-www-form-urlencoded"
    Http.send(data) 
    if Http.readystate<>4 then 
    exit function 
    End if
    PostHTTPPage=bytesToBSTR(Http.responseBody,"UTF-8")
    set http=nothing 
    if err.number<>0 then err.Clear 
End function

'提交数据
dim postdata, strTest
postdata="appid=&appid&"&module="&module&"&company="&company&"&order="&order&"&sign="&sign
strTest=PostHTTPPage(apiurl,postdata)

'返回结果
response.write(strTest)
response.end

常见问题

API 接口参数为空

此错误返回 JSON 数据如下:

{
    "result":0,
    "description":"API接口参数为空",
    "flag":"appid:sign"
}

解决方法:
1)请检查 appid 及 sign 是否为空;
2)确保 appid 是从官网获取到正确的接口授权;
3)确保 sign 计算生成是正确的。

API 接口参数无效

此错误返回 JSON 数据如下:

{
    "result":0,
    "description":"API接口参数无效",
    "flag":"appid"
}

解决方法:
1)请检查 appid 是否正确;
2)确保 appid 是从官网获取到正确的接口授权。

API 接口授权已到期

此错误返回 JSON 数据如下:

{
    "result":0,
    "description":"API接口授权已到期",
    "flag":"end:2018-12-31 23:59:59"
}

解决方法:
1)请检查 appid 对应接口授权的期限是否过期;
2)如果接口授权过期,请到官网更新(免费用户直接更新,无需续费)或续费(针对商业付费用户)。

签名错误

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

此错误返回 JSON 数据如下:

{
    "result":0,
    "description":"签名错误",
    "flag":"getExpressInfo->sign"
}

解决方法:
1)请检查 sign 签名计算是否正确;
2)签名 sign 根据公式 $sign=sha256(appid=$appid&module=getExpressInfo&order=$order&appkey=$appkey) 生成;其中:appkey 为授权接口的 AppKey,请填写您在我要查官网上申请到的 AppKey 。

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

此错误返回 JSON 数据如下:

{
    "result":0,
    "description":"签名错误",
    "flag":"getExpressInfoNoSmart->sign"
}

解决方法:
1)请检查 sign 签名计算是否正确;
2)签名 sign 根据公式 $sign=sha256(appid=$appid&module=getExpressInfoNoSmart&company=$company&order=$order&appkey=$appkey) 生成;其中:appkey 为授权接口的 AppKey,请填写您在我要查官网上申请到的 AppKey 。

请求受限

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

此错误返回 JSON 数据如下:

{
    "result":0,
    "description":"请求受限",
    "flag":"getExpressInfo->daylimit"
}

解决方法:
1)授权接口已超出当前接口产品请求的最大限制;
2)请根据实际使用需求升级您的接口产品。

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

此错误返回 JSON 数据如下:

{
    "result":0,
    "description":"请求受限",
    "flag":"getExpressInfoNoSmart->daylimit"
}

解决方法:
1)授权接口已超出当前接口产品请求的最大限制;
2)请根据实际使用需求升级您的接口产品。

其他问题

如果您遇到其他的问题,请用以下方式联系我们,我们将为您提供 API 技术对接帮助。

请直接添加 QQ 技术交流群寻求我们帮助。
我要查API技术对接群①:
群号:821884327
扫码加入我要查API技术对接群①: