當前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

快递查询（快递单号智能识别/快递公司+快递单号）-完整提供 Demo 代码示例及数据专业且全面的 API 查询接口

發布時間：2023/12/8 编程问答 95 豆豆

生活随笔收集整理的這篇文章主要介紹了快递查询（快递单号智能识别/快递公司+快递单号）-完整提供 Demo 代码示例及数据专业且全面的 API 查询接口小編覺得挺不錯的,現在分享給大家,幫大家做個參考.

更多資料請參考：www.woyaocha.net/product/express

查詢說明

接口一：快遞單號智能識別

快遞單號智能識別，是根據查詢的快遞單號自動智能識別出該運單所屬的快遞公司，再獲取快遞公司及實時的運單狀態和運單狀態等信息。

接口二：快遞公司+快遞單號

快遞公司+快遞單號，是根據查詢的快遞公司和快遞單號，獲取快遞公司及實時的運單狀態和運單狀態等信息。

接口描述

功能描述

獲取快遞公司及實時的運單狀態和運單狀態等信息。

URL 示例

接口一：快遞單號智能識別

1）http 協議：

POST 方式請求：

Copy

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

GET 方式請求：

Copy

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

2）https 協議：

POST 方式請求：

Copy

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

GET 方式請求：

Copy

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

接口二：快遞公司+快遞單號

1）http 協議：

POST 方式請求：

Copy

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

GET 方式請求：

Copy

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

2）https 協議：

POST 方式請求：

Copy

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

GET 方式請求：

Copy

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

請求參數

數據包體

接口一：快遞單號智能識別

Copy

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

接口二：快遞公司+快遞單號

Copy

{"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：快遞公司，賦值快遞公司代碼或擴展代碼均可。

構造偽代碼如下：

接口一：快遞單號智能識別

Copy

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

接口二：快遞公司+快遞單號

Copy

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

響應參數

數據包體

Copy

{"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 方式請求數據

Copy

//接口參數 $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 方式請求數據

Copy

//接口參數 $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 方式請求數據

Copy

//接口參數 $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 方式請求數據

Copy

//接口參數 $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

接口一：快遞單號智能識別

Copy

//以下示例是以 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");

接口二：快遞公司+快遞單號

Copy

//以下示例是以 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

接口一：快遞單號智能識別

Copy

#!/usr/bin/python # -*- coding: utf-8 -*- import httplib2 import hashlib from urllib.parse import urlencode #python3 #from urllib import urlencode #python2apiurl='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"))

接口二：快遞公司+快遞單號

Copy

#!/usr/bin/python # -*- coding: utf-8 -*- import httplib2 import hashlib from urllib.parse import urlencode #python3 #from urllib import urlencode #python2apiurl='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 方式請求數據

Copy

//以 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 方式請求數據

Copy

//以 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 方式請求數據

Copy

//以 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 方式請求數據

Copy

//以 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

接口一：快遞單號智能識別

Copy

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

接口二：快遞公司+快遞單號

Copy

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 方式請求數據

Copy

//使用 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 方式請求數據

Copy

接口二：快遞公司+快遞單號

方法一：以 POST 方式請求數據

Copy

//使用 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 方式請求數據

Copy

//使用 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

接口一：快遞單號智能識別

Copy

'設置參數 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,falseHttp.setRequestHeader "Content-Type", "application/x-www-form-urlencoded"Http.send(data) if Http.readystate<>4 then exit function End ifPostHTTPPage=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

接口二：快遞公司+快遞單號

Copy

'設置參數 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,falseHttp.setRequestHeader "Content-Type", "application/x-www-form-urlencoded"Http.send(data) if Http.readystate<>4 then exit function End ifPostHTTPPage=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 數據如下：

Copy

{"result":0,"description":"API接口參數為空","flag":"appid:sign" }

解決方法：
1）請檢查 appid 及 sign 是否為空；
2）確保 appid 是從官網獲取到正確的接口授權；
3）確保 sign 計算生成是正確的。

API 接口參數無效

此錯誤返回 JSON 數據如下：

Copy

{"result":0,"description":"API接口參數無效","flag":"appid" }

解決方法：
1）請檢查 appid 是否正確；
2）確保 appid 是從官網獲取到正確的接口授權。

API 接口授權已到期

此錯誤返回 JSON 數據如下：

Copy

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

解決方法：
1）請檢查 appid 對應接口授權的期限是否過期；
2）如果接口授權過期，請到官網更新（免費用戶直接更新，無需續費）或續費（針對商業付費用戶）。

簽名錯誤

接口一：快遞單號智能識別

此錯誤返回 JSON 數據如下：

Copy

{"result":0,"description":"簽名錯誤","flag":"getExpressInfo->sign" }

解決方法：
1）請檢查 sign 簽名計算是否正確；
2）簽名 sign 根據公式 $sign=sha256(appid=$appid&module=getExpressInfo&order=$order&appkey=$appkey) 生成；其中：appkey 為授權接口的 AppKey，請填寫您在我要查官網上申請到的 AppKey 。

接口二：快遞公司+快遞單號

此錯誤返回 JSON 數據如下：

Copy

{"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 數據如下：

Copy

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

解決方法：
1）授權接口已超出當前接口產品請求的最大限制；
2）請根據實際使用需求升級您的接口產品。

接口二：快遞公司+快遞單號

此錯誤返回 JSON 數據如下：

Copy

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

解決方法：
1）授權接口已超出當前接口產品請求的最大限制；
2）請根據實際使用需求升級您的接口產品。

總結

以上是生活随笔為你收集整理的快递查询（快递单号智能识别/快递公司+快递单号）-完整提供 Demo 代码示例及数据专业且全面的 API 查询接口的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。

上一篇：通过kiwix浏览wikipedia
下一篇： canvas动画粒子效果分享，可以做背景