更多資料請(qǐng)參考：www.woyaocha.net/product/express

查詢說(shuō)明

接口一：快遞單號(hào)智能識(shí)別

快遞單號(hào)智能識(shí)別，是根據(jù)查詢的快遞單號(hào)自動(dòng)智能識(shí)別出該運(yùn)單所屬的快遞公司，再獲取快遞公司及實(shí)時(shí)的運(yùn)單狀態(tài)和運(yùn)單狀態(tài)等信息。

接口二：快遞公司+快遞單號(hào)

快遞公司+快遞單號(hào)，是根據(jù)查詢的快遞公司和快遞單號(hào)，獲取快遞公司及實(shí)時(shí)的運(yùn)單狀態(tài)和運(yùn)單狀態(tài)等信息。

接口描述

功能描述

獲取快遞公司及實(shí)時(shí)的運(yùn)單狀態(tài)和運(yùn)單狀態(tài)等信息。

URL 示例

接口一：快遞單號(hào)智能識(shí)別

1）http 協(xié)議：

POST 方式請(qǐng)求：

Copy

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

GET 方式請(qǐng)求：

Copy

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

2）https 協(xié)議：

POST 方式請(qǐng)求：

Copy

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

GET 方式請(qǐng)求：

Copy

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

接口二：快遞公司+快遞單號(hào)

1）http 協(xié)議：

POST 方式請(qǐng)求：

Copy

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

GET 方式請(qǐng)求：

Copy

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

2）https 協(xié)議：

POST 方式請(qǐng)求：

Copy

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

GET 方式請(qǐng)求：

Copy

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

請(qǐng)求參數(shù)

數(shù)據(jù)包體

接口一：快遞單號(hào)智能識(shí)別

Copy

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

接口二：快遞公司+快遞單號(hào)

Copy

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

參數(shù)說(shuō)明

接口一：快遞單號(hào)智能識(shí)別

參數(shù)必選類型描述

type	否	string	授權(quán)接口的請(qǐng)求方式
appid	是	string	授權(quán)接口的 AppID，請(qǐng)?zhí)顚懩谖乙楣倬W(wǎng)上申請(qǐng)到的 AppID
module	是	string	目標(biāo)請(qǐng)求的數(shù)據(jù)模塊，根據(jù)快遞單號(hào)智能查詢快遞信息為：getExpressInfo
order	是	string	目標(biāo)要查詢的快遞單號(hào)，支持的快遞公司及參數(shù)對(duì)照見下面的其他說(shuō)明
sign	是	string	請(qǐng)求憑證，具體計(jì)算方式見下面的其他說(shuō)明

接口二：快遞公司+快遞單號(hào)

參數(shù)必選類型描述

type	否	string	授權(quán)接口的請(qǐng)求方式
appid	是	string	授權(quán)接口的 AppID，請(qǐng)?zhí)顚懩谖乙楣倬W(wǎng)上申請(qǐng)到的 AppID
module	是	string	目標(biāo)請(qǐng)求的數(shù)據(jù)模塊，根據(jù)快遞公司和快遞單號(hào)查詢快遞信息為：getExpressInfoNoSmart
company	是	string	目標(biāo)要查詢的快遞公司，支持的快遞公司及參數(shù)對(duì)照見下面的快遞公司代碼，代碼或擴(kuò)展代碼均可
order	是	string	目標(biāo)要查詢的快遞單號(hào)，支持的快遞公司及參數(shù)對(duì)照見下面的快遞公司代碼
sign	是	string	請(qǐng)求憑證，具體計(jì)算方式見下面的其他說(shuō)明

快遞公司代碼

支持的快遞公司代碼及參數(shù)對(duì)照如下表：

序號(hào)快遞公司代碼擴(kuò)展代碼快遞公司

1	360zebra	ZY_BM	斑馬物聯(lián)網(wǎng)(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	澳郵中國(guó)快運(yùn)(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	孟加拉國(guó) EMS(Bangladesh EMS)
21	beihaiguoji	BHGJ	貝海國(guó)際速遞
22	belgium_post	BEL	比利時(shí)郵政(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	秦遠(yuǎn)物流
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國(guó)內(nèi)快遞
60	feiyang	ZY_FY	飛洋快遞
61	fkd	FKD	飛康達(dá)快遞
62	flytexpress	IFTWL	飛特物流(Flyt Express)
63	ftd	FTD	富騰達(dá)快遞
64	gdems	GDEMS	廣東ems快遞
65	gsdwl	GSD	共速達(dá)物流
66	gtsd	GTSD	高鐵速遞
67	guada	GD	冠達(dá)快遞
68	guangtong	GTONG	廣通速遞
69	guotong	GTO	國(guó)通快遞
70	henglu	HLWL	恒路物流
71	hhexp	HHWL	華翰物流
72	hong_kong_post	XGYZ	香港郵政(Hong Kong Post)
73	huaqi	HQKD	華企快遞
74	huiqiang	ZHQKD	匯強(qiáng)快遞
75	hxlwl	HXLWL	華夏龍物流
76	japan_post	JP	日本郵政(Japan Post)
77	jiayunmei	JYM	加運(yùn)美快遞
78	jiete	JTKD	捷特快遞
79	jingdong	JD	京東快遞
80	jingguang	JGSD	京廣快遞
81	jinyue	JYKD	晉越快遞
82	jldt	JLDT	嘉里大通物流
83	jywl	JYWL	佳怡物流
84	korea_post	IHGYZ	韓國(guó)郵政(Korea Post)
85	kuaijie	FAST	快捷快遞
86	kysy	KYSY	跨越速運(yùn)
87	lianhaotong	LHT	聯(lián)昊通快遞
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	英國(guó)郵政(Parcel Force)
95	pinganda	PADTF	平安達(dá)快遞
96	pinjun	PJ	品駿快遞
97	qichen	VENUCIA	啟辰國(guó)際物流(venucia)
98	quanchen	QCKD	全晨快遞
99	quanfeng	QFKD	全峰快遞
100	quanritong	QRT	全日通快遞
101	quanyi	UAPEX	全一快遞
102	rrs	RRS	日日順物流
103	rufengda	RFD	如風(fēng)達(dá)快遞
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	優(yōu)邦速運(yùn)
118	ups	UPS	UPS國(guó)際快遞
119	weitepai	WTP	微特派快遞
120	wxwl	WXWL	萬(wàn)象物流
121	xdexpress	XD	迅達(dá)速遞
122	xfwl	XFEX	信豐物流
123	xinbang	XBWL	新邦物流
124	xinjie	XJ	新杰物流
125	yad	YADEX	源安達(dá)快遞
126	yafeng	YFSD	亞風(fēng)快遞
127	ycky	YCWL	遠(yuǎn)成快運(yùn)
128	ycwl	YCWL	遠(yuǎn)成物流
129	yitongda	IYTG	易通達(dá)
130	ymdd	YMDD	壹米滴答物流
131	yousu	UC	優(yōu)速快遞
132	yuanfeihang	YFHEX	原飛航快遞
133	yuantong	YTO	圓通快遞
134	yuefeng	YFEX	越豐快遞
135	yunda	YD	韻達(dá)快遞
136	bgpyghx	YZPY	郵政包裹、平郵、掛號(hào)信
137	zengyi	ZENY	增益快遞
138	zhongtie	ZTKY	中鐵快運(yùn)
139	zhongtong	ZTO	中通快遞
140	zhongyou	CNPEX	中郵物流
141	zjs	ZJS	宅急送快遞

其他說(shuō)明

1）type：可選值 get，如果賦值 get，則以 get 方式提交數(shù)據(jù)；默認(rèn)以 post 方式提交數(shù)據(jù)；
2）sign：簽名校驗(yàn)
當(dāng) module 賦值 getExpressInfo 時(shí)，根據(jù)公式 $sign=sha256(appid=$appid&module=getExpressInfo&order=$order&appkey=$appkey) 生成；
當(dāng) module 賦值 getExpressInfoNoSmart 時(shí)，根據(jù)公式 $sign=sha256(appid=$appid&module=getExpressInfoNoSmart&company=$company&order=$order&appkey=$appkey) 生成；
其中：appkey 為授權(quán)接口的 AppKey，請(qǐng)?zhí)顚懩谖乙楣倬W(wǎng)上申請(qǐng)到的 AppKey 。
3）company：快遞公司，賦值快遞公司代碼或擴(kuò)展代碼均可。

構(gòu)造偽代碼如下：

接口一：快遞單號(hào)智能識(shí)別

Copy

string type = "get"; //請(qǐng)求方式，可以賦值為：post string appid = "1000xxxx"; //sdkappid 對(duì)應(yīng)的 appid，需要業(yè)務(wù)方高度保密 string module = "getExpressInfo"; //請(qǐng)求的數(shù)據(jù)模塊，此處賦值：getExpressInfo string order = "247198050163"; //要查詢的快遞單號(hào) string sign = sha256(appid=1000xxxx&module=getExpressInfo&order=247198050163&appkey=56cf61af4b7897e704f67deb88ae8f24);

接口二：快遞公司+快遞單號(hào)

Copy

string type = "get"; //請(qǐng)求方式，可以賦值為：post string appid = "1000xxxx"; //sdkappid 對(duì)應(yīng)的 appid，需要業(yè)務(wù)方高度保密 string module = "getExpressInfoNoSmart"; //請(qǐng)求的數(shù)據(jù)模塊，此處賦值：getExpressInfoNoSmart string company = "shunfeng"; //要查詢的快遞公司 string order = "247198050163"; //要查詢的快遞單號(hào) string sign = sha256(appid=1000xxxx&module=getExpressInfoNoSmart&company=shunfeng&order=247198050163&appkey=56cf61af4b7897e704f67deb88ae8f24);

響應(yīng)參數(shù)

數(shù)據(jù)包體

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":"順豐速運(yùn) 已收取快件"},{"time":"2018-06-06 19:37:16","content":"快件在【武漢硚口區(qū)硚口營(yíng)業(yè)點(diǎn)】已裝車,準(zhǔn)備發(fā)往 【武漢走馬嶺集散中心】"},{"time":"2018-06-06 19:47:53","content":"快件已發(fā)車"},{"time":"2018-06-06 20:51:13","content":"快件到達(dá) 【武漢走馬嶺集散中心】"},{"time":"2018-06-06 20:53:46","content":"快件在【武漢走馬嶺集散中心】已裝車,準(zhǔn)備發(fā)往下一站"},{"time":"2018-06-06 21:26:00","content":"快件已發(fā)車"},{"time":"2018-06-06 22:17:29","content":"快件到達(dá) 【武漢總集散中心】"},{"time":"2018-06-07 00:08:13","content":"快件在【武漢總集散中心】已裝車,準(zhǔn)備發(fā)往下一站"},{"time":"2018-06-07 03:16:03","content":"快件到達(dá) 【杭州總集散中心】"},{"time":"2018-06-07 05:45:20","content":"快件在【杭州總集散中心】已裝車,準(zhǔn)備發(fā)往下一站"},{"time":"2018-06-07 08:57:00","content":"快件到達(dá) 【福州總集散中心】"},{"time":"2018-06-07 08:57:30","content":"快件在【福州總集散中心】已裝車,準(zhǔn)備發(fā)往 【福州尚干集散中心】"},{"time":"2018-06-07 09:30:24","content":"快件已發(fā)車"},{"time":"2018-06-07 10:31:35","content":"快件到達(dá) 【福州尚干集散中心】"},{"time":"2018-06-07 11:16:19","content":"快件在【福州尚干集散中心】已裝車,準(zhǔn)備發(fā)往 【泉州晉江集散中心】"},{"time":"2018-06-07 12:17:36","content":"快件已發(fā)車"},{"time":"2018-06-07 15:26:19","content":"快件到達(dá) 【泉州晉江集散中心】"},{"time":"2018-06-07 15:52:54","content":"快件在【泉州晉江集散中心】已裝車,準(zhǔn)備發(fā)往下一站"},{"time":"2018-06-07 17:16:21","content":"快件已發(fā)車"},{"time":"2018-06-07 17:52:49","content":"快件到達(dá) 【泉州豐澤招豐村路營(yíng)業(yè)點(diǎn)】"},{"time":"2018-06-08 08:23:14","content":"快件交給周松壽，正在派送途中（聯(lián)系電話：15906062987）"},{"time":"2018-06-08 09:38:23","content":"快件派送至【豐巢智能快遞柜】,請(qǐng)您憑取件碼至電力職業(yè)技術(shù)學(xué)院原二號(hào)教學(xué)樓旁車庫(kù)領(lǐng)取您的快遞."},{"time":"2018-06-08 15:38:40","content":"已簽收(豐巢簽收),感謝使用順豐,期待再次為您服務(wù)"}]} }

參數(shù)說(shuō)明

參數(shù)必選類型描述

result	是	string	接口響應(yīng)結(jié)果：0-失敗；1-成功
description	是	string	接口響應(yīng)描述：一般為 TURE（result=1） 與 FALSE（result=0），或者返回錯(cuò)誤信息
flag	否	string	錯(cuò)誤說(shuō)明，沒(méi)有錯(cuò)誤則返回空
expressInfo	是	object	返回手機(jī)號(hào)碼歸屬地信息

expressInfo 參數(shù)說(shuō)明：

參數(shù)必選類型描述

id	是	string	快遞公司代碼，如：順豐-shunfeng、申通-shentong，具體請(qǐng)查看上面的快遞公司代碼
name	是	string	快遞公司名稱
order	是	string	快遞單號(hào)，請(qǐng)注意區(qū)分大小寫
message	否	string	輸出消息內(nèi)容（可忽略），一般返回空
errcode	是	string	返回錯(cuò)誤碼： 0-無(wú)錯(cuò)誤； 1-快遞KEY無(wú)效； 2-快遞代號(hào)無(wú)效； 3-訪問(wèn)次數(shù)達(dá)到最大額度； 4-查詢服務(wù)器返回錯(cuò)誤即返回狀態(tài)碼非200； 5-程序執(zhí)行出錯(cuò)
status	是	string	訂單跟蹤狀態(tài)： 0-查詢出錯(cuò)（即errCode!=0）； 1-暫無(wú)記錄； 2-在途中； 3-派送中； 4-已簽收； 5-拒收； 6-疑難件； 7-退回
data	是	object	運(yùn)單跟蹤數(shù)據(jù)集合

data 參數(shù)說(shuō)明：

參數(shù)必選類型描述

time	是	string	運(yùn)單時(shí)間節(jié)點(diǎn)
content	是	string	運(yùn)單時(shí)間節(jié)點(diǎn)對(duì)應(yīng)的狀態(tài)

SDK 及代碼示例

PHP SDK

接口一：快遞單號(hào)智能識(shí)別

方法一：以 POST 方式請(qǐng)求數(shù)據(jù)

Copy

//接口參數(shù) $api_url='http://cha.ebaitian.cn/api/json'; $api_appid='1000xxxx'; $api_appkey='56cf61af4b7897e704f67deb88ae8f24';//函數(shù)，以POST方式提交數(shù)據(jù)，PHP需要開啟CURL函數(shù)；數(shù)據(jù)傳輸安全，建議使用 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; } //調(diào)用函數(shù) $order='247198050163'; echo getExpressInfo($order); exit;

方法二：以 GET 方式請(qǐng)求數(shù)據(jù)

Copy

//接口參數(shù) $api_url='http://cha.ebaitian.cn/api/json'; $api_appid='1000xxxx'; $api_appkey='56cf61af4b7897e704f67deb88ae8f24';//函數(shù)，以GET方式提交數(shù)據(jù) 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; } //調(diào)用函數(shù) $order='247198050163'; echo getExpressInfo($order); exit;

接口二：快遞公司+快遞單號(hào)

方法一：以 POST 方式請(qǐng)求數(shù)據(jù)

Copy

//接口參數(shù) $api_url='http://cha.ebaitian.cn/api/json'; $api_appid='1000xxxx'; $api_appkey='56cf61af4b7897e704f67deb88ae8f24';//函數(shù)，以POST方式提交數(shù)據(jù)，PHP需要開啟CURL函數(shù)；數(shù)據(jù)傳輸安全，建議使用 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; } //調(diào)用函數(shù) $order='247198050163'; echo getExpressInfo($order); exit;

方法二：以 GET 方式請(qǐng)求數(shù)據(jù)

Copy

//接口參數(shù) $api_url='http://cha.ebaitian.cn/api/json'; $api_appid='1000xxxx'; $api_appkey='56cf61af4b7897e704f67deb88ae8f24';//函數(shù)，以GET方式提交數(shù)據(jù) 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; } //調(diào)用函數(shù) $order='247198050163'; echo getExpressInfo($company,$order); exit;

Java SDK

接口一：快遞單號(hào)智能識(shí)別

Copy

//以下示例是以 GET 方式請(qǐng)求數(shù)據(jù) 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");

接口二：快遞公司+快遞單號(hào)

Copy

//以下示例是以 GET 方式請(qǐng)求數(shù)據(jù) 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

接口一：快遞單號(hào)智能識(shí)別

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

接口二：快遞公司+快遞單號(hào)

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

接口一：快遞單號(hào)智能識(shí)別

方法一：以 POST 方式請(qǐng)求數(shù)據(jù)

Copy

//以 POST 方式提交 var http = require('http'); var querystring = require('querystring'); //參數(shù)設(shè)置 var appid = '1000xxxx'; var appkey = '56cf61af4b7897e704f67deb88ae8f24'; var module = 'getExpressInfo';//目標(biāo)查詢快遞單號(hào) var order='247198050163';//簽名，SHA256 不可直接調(diào)用；函數(shù)參考下載地址：https://github.com/alexweber/jquery.sha256 var sign = SHA256('appid='+appid+'&module='+module+'&order='+order+'&appkey='+appkey);//這是需要提交的數(shù)據(jù) 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 方式請(qǐng)求數(shù)據(jù)

Copy

//以 GET 方式提交 var http = require('http'); var querystring = require('querystring'); //參數(shù)設(shè)置 var appid = '1000xxxx'; var appkey = '56cf61af4b7897e704f67deb88ae8f24'; var module = 'getExpressInfo';//目標(biāo)查詢快遞單號(hào) var order='247198050163';//簽名，SHA256 不可直接調(diào)用；函數(shù)參考下載地址：https://github.com/alexweber/jquery.sha256 var sign = SHA256('appid='+appid+'&module='+module+'&order='+order+'&appkey='+appkey);//這是需要提交的數(shù)據(jù) 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();

接口二：快遞公司+快遞單號(hào)

方法一：以 POST 方式請(qǐng)求數(shù)據(jù)

Copy

//以 POST 方式提交 var http = require('http'); var querystring = require('querystring'); //參數(shù)設(shè)置 var appid = '1000xxxx'; var appkey = '56cf61af4b7897e704f67deb88ae8f24'; var module = 'getExpressInfoNoSmart';//目標(biāo)查詢快遞公司及快遞單號(hào) var company='shunfeng'; var order='247198050163';//簽名，SHA256 不可直接調(diào)用；函數(shù)參考下載地址：https://github.com/alexweber/jquery.sha256 var sign = SHA256('appid='+appid+'&module='+module+'&company='+company+'&order='+order+'&appkey='+appkey);//這是需要提交的數(shù)據(jù) 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 方式請(qǐng)求數(shù)據(jù)

Copy

//以 GET 方式提交 var http = require('http'); var querystring = require('querystring'); //參數(shù)設(shè)置 var appid = '1000xxxx'; var appkey = '56cf61af4b7897e704f67deb88ae8f24'; var module = 'getExpressInfoNoSmart';//目標(biāo)查詢快遞公司及快遞單號(hào) var company='shunfeng'; var order='247198050163';//簽名，SHA256 不可直接調(diào)用；函數(shù)參考下載地址：https://github.com/alexweber/jquery.sha256 var sign = SHA256('appid='+appid+'&module='+module+'&company='+company+'&order='+order+'&appkey='+appkey);//這是需要提交的數(shù)據(jù) 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

接口一：快遞單號(hào)智能識(shí)別

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

接口二：快遞公司+快遞單號(hào)

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

接口一：快遞單號(hào)智能識(shí)別

方法一：以 POST 方式請(qǐng)求數(shù)據(jù)

Copy

//使用 JQuery 請(qǐng)先加載最新的 JQuery 插件 //參數(shù)設(shè)置 var apiurl = 'http://cha.ebaitian.cn/api/json'; var appid = '1000xxxx'; var appkey = '56cf61af4b7897e704f67deb88ae8f24'; var module = 'getExpressInfo';//目標(biāo)查詢快遞單號(hào) var order='247198050163';//簽名，SHA256 不可直接調(diào)用；函數(shù)參考下載地址：https://github.com/alexweber/jquery.sha256 var sign = SHA256('appid='+appid+'&module='+module+'&order='+order+'&appkey='+appkey);//提交數(shù)據(jù) $.ajax({url:apiurl,type:'post',dataType:'json',data:{appid:appid,module:module,order:order,sign:sign},success:function(res){console.log(res);} });

方法二：以 GET 方式請(qǐng)求數(shù)據(jù)

Copy

//使用 JQuery 請(qǐng)先加載最新的 JQuery 插件 //參數(shù)設(shè)置 var apiurl = 'http://cha.ebaitian.cn/api/json'; var appid = '1000xxxx'; var appkey = '56cf61af4b7897e704f67deb88ae8f24'; var module = 'getExpressInfo';//目標(biāo)查詢快遞單號(hào) var order='247198050163';//簽名，SHA256 不可直接調(diào)用；函數(shù)參考下載地址：https://github.com/alexweber/jquery.sha256 var sign = SHA256('appid='+appid+'&module='+module+'&order='+order+'&appkey='+appkey);//提交數(shù)據(jù) $.ajax({url:apiurl,type:'post',dataType:'json',data:{appid:appid,module:module,order:order,sign:sign},success:function(res){console.log(res);} });

接口二：快遞公司+快遞單號(hào)

方法一：以 POST 方式請(qǐng)求數(shù)據(jù)

Copy

//使用 JQuery 請(qǐng)先加載最新的 JQuery 插件 //參數(shù)設(shè)置 var apiurl = 'http://cha.ebaitian.cn/api/json'; var appid = '1000xxxx'; var appkey = '56cf61af4b7897e704f67deb88ae8f24'; var module = 'getExpressInfoNoSmart';//目標(biāo)查詢快遞公司及快遞單號(hào) var company='shunfeng'; var order='247198050163';//簽名，SHA256 不可直接調(diào)用；函數(shù)參考下載地址：https://github.com/alexweber/jquery.sha256 var sign = SHA256('appid='+appid+'&module='+module+'&company='+company+'&order='+order+'&appkey='+appkey);//提交數(shù)據(jù) $.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 方式請(qǐng)求數(shù)據(jù)

Copy

//使用 JQuery 請(qǐng)先加載最新的 JQuery 插件 //參數(shù)設(shè)置 var apiurl = 'http://cha.ebaitian.cn/api/json'; var appid = '1000xxxx'; var appkey = '56cf61af4b7897e704f67deb88ae8f24'; var module = 'getExpressInfoNoSmart';//目標(biāo)查詢快遞公司及快遞單號(hào) var company='shunfeng'; var order='247198050163';//簽名，SHA256 不可直接調(diào)用；函數(shù)參考下載地址：https://github.com/alexweber/jquery.sha256 var sign = SHA256('appid='+appid+'&module='+module+'&company='+company+'&order='+order+'&appkey='+appkey);//提交數(shù)據(jù) $.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

接口一：快遞單號(hào)智能識(shí)別

Copy

'設(shè)置參數(shù) dim apiurl, appid, appkey, module, order, sign apiurl="http://cha.ebaitian.cn/api/json" appid="1000xxxx' appkey="56cf61af4b7897e704f67deb88ae8f24" module="getExpressInfo" order="247198050163"'簽名，SHA256 不可直接調(diào)用；函數(shù)參考地址：https://blog.csdn.net/yesoce/article/details/128546 sgin=SHA256("appid=&appid&"&module="&module&"&order="&order&"&appkey="&appkey)'異步提交數(shù)據(jù) 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'提交數(shù)據(jù) dim postdata, strTest postdata="appid=&appid&"&module="&module&"&order="&order&"&sign="&sign strTest=PostHTTPPage(apiurl,postdata)'返回結(jié)果 response.write(strTest) response.end

接口二：快遞公司+快遞單號(hào)

Copy

'設(shè)置參數(shù) 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 不可直接調(diào)用；函數(shù)參考地址：https://blog.csdn.net/yesoce/article/details/128546 sgin=SHA256("appid=&appid&"&module="&module&"&company="&company&"&order="&order&"&appkey="&appkey)'異步提交數(shù)據(jù) 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'提交數(shù)據(jù) dim postdata, strTest postdata="appid=&appid&"&module="&module&"&company="&company&"&order="&order&"&sign="&sign strTest=PostHTTPPage(apiurl,postdata)'返回結(jié)果 response.write(strTest) response.end

常見問(wèn)題

API 接口參數(shù)為空

此錯(cuò)誤返回 JSON 數(shù)據(jù)如下：

Copy

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

解決方法：
1）請(qǐng)檢查 appid 及 sign 是否為空；
2）確保 appid 是從官網(wǎng)獲取到正確的接口授權(quán)；
3）確保 sign 計(jì)算生成是正確的。

API 接口參數(shù)無(wú)效

此錯(cuò)誤返回 JSON 數(shù)據(jù)如下：

Copy

{"result":0,"description":"API接口參數(shù)無(wú)效","flag":"appid" }

解決方法：
1）請(qǐng)檢查 appid 是否正確；
2）確保 appid 是從官網(wǎng)獲取到正確的接口授權(quán)。

API 接口授權(quán)已到期

此錯(cuò)誤返回 JSON 數(shù)據(jù)如下：

Copy

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

解決方法：
1）請(qǐng)檢查 appid 對(duì)應(yīng)接口授權(quán)的期限是否過(guò)期；
2）如果接口授權(quán)過(guò)期，請(qǐng)到官網(wǎng)更新（免費(fèi)用戶直接更新，無(wú)需續(xù)費(fèi)）或續(xù)費(fèi)（針對(duì)商業(yè)付費(fèi)用戶）。

簽名錯(cuò)誤

接口一：快遞單號(hào)智能識(shí)別

此錯(cuò)誤返回 JSON 數(shù)據(jù)如下：

Copy

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

解決方法：
1）請(qǐng)檢查 sign 簽名計(jì)算是否正確；
2）簽名 sign 根據(jù)公式 $sign=sha256(appid=$appid&module=getExpressInfo&order=$order&appkey=$appkey) 生成；其中：appkey 為授權(quán)接口的 AppKey，請(qǐng)?zhí)顚懩谖乙楣倬W(wǎng)上申請(qǐng)到的 AppKey 。

接口二：快遞公司+快遞單號(hào)

此錯(cuò)誤返回 JSON 數(shù)據(jù)如下：

Copy

{"result":0,"description":"簽名錯(cuò)誤","flag":"getExpressInfoNoSmart->sign" }

解決方法：
1）請(qǐng)檢查 sign 簽名計(jì)算是否正確；
2）簽名 sign 根據(jù)公式 $sign=sha256(appid=$appid&module=getExpressInfoNoSmart&company=$company&order=$order&appkey=$appkey) 生成；其中：appkey 為授權(quán)接口的 AppKey，請(qǐng)?zhí)顚懩谖乙楣倬W(wǎng)上申請(qǐng)到的 AppKey 。

請(qǐng)求受限

接口一：快遞單號(hào)智能識(shí)別

此錯(cuò)誤返回 JSON 數(shù)據(jù)如下：

Copy

{"result":0,"description":"請(qǐng)求受限","flag":"getExpressInfo->daylimit" }

解決方法：
1）授權(quán)接口已超出當(dāng)前接口產(chǎn)品請(qǐng)求的最大限制；
2）請(qǐng)根據(jù)實(shí)際使用需求升級(jí)您的接口產(chǎn)品。

接口二：快遞公司+快遞單號(hào)

此錯(cuò)誤返回 JSON 數(shù)據(jù)如下：

Copy

{"result":0,"description":"請(qǐng)求受限","flag":"getExpressInfoNoSmart->daylimit" }

解決方法：
1）授權(quán)接口已超出當(dāng)前接口產(chǎn)品請(qǐng)求的最大限制；
2）請(qǐng)根據(jù)實(shí)際使用需求升級(jí)您的接口產(chǎn)品。

總結(jié)

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

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。