國(guó)際郵政包裹查詢網(wǎng)
國(guó)際郵政包裹查詢網(wǎng)查詢API 接口技術(shù)文檔一、接口功能輸入國(guó)際郵包單號(hào)，輸出郵包的最新事件，投遞狀態(tài)。采用http 請(qǐng)求方式，支持xml 、json 、base64、txt 、map 、jsonp 等
國(guó)際郵政包裹查詢網(wǎng)
查詢API 接口技術(shù)文檔
一、接口功能
輸入國(guó)際郵包單號(hào)，輸出郵包的最新事件，投遞狀態(tài)。
采用http 請(qǐng)求方式，支持xml 、json 、base64、txt 、map 、jsonp 等六種數(shù)據(jù)類型的返回。
備注：
1. 返回結(jié)果每天都會(huì)更新，建議不要cache 數(shù)據(jù)，以免引起錯(cuò)誤。
2. 建議每天實(shí)時(shí)調(diào)用本接口數(shù)據(jù)來(lái)進(jìn)行目標(biāo)系統(tǒng)的郵包投遞信息的更新。
二、接口使用
（1）接口概述
a. 郵包查詢主接口:
b. 文字翻譯輔助接口
本API 的正式域名為：api.sao.cn ；
（2）接口統(tǒng)一請(qǐng)求方式
采用HTTP 請(qǐng)求方式。 GET, POST均可以。
（3）郵包查詢輸入?yún)?shù)說(shuō)明
（4）郵包查詢請(qǐng)求示例
(1). 返回JSON 數(shù)據(jù)
(2). 返回XML 數(shù)據(jù)
(3). 返回TXT 文本
（5）郵包查詢輸出參數(shù)說(shuō)明
（6）郵包查詢輸出示例
a. 郵包查詢返回XML 示例
b. 郵包查詢返回JSON 示例
c. 郵包查詢返回TXT 示例
d. 郵包查詢返回Map 示例
e. 郵包查詢返回Base64示例
f. 郵包查詢返回Base64示例
如傳入?yún)?shù)type=jsonp_mailinfo
則返回 var jsonp_mailinfo = {JSON數(shù)據(jù)} ; mailinfo 是任意的名字
g. 郵包查詢返回Base64示例
如傳入?yún)?shù)type=callback_fuc
則返回 callback_fuc( {JSON數(shù)據(jù)} ) ; fuc 是任意的名字
（7）文字翻譯輸入?yún)?shù)說(shuō)明
,
（8）文字翻譯請(qǐng)求示例
(a). 返回Txt 數(shù)據(jù)
（9）文字翻譯輸出參數(shù)說(shuō)明
(a) 直接輸入翻譯后的文本, 采用UTF-8編碼。
三、接口編碼對(duì)照表
（1）郵包類型編碼對(duì)照表
（2）郵包狀態(tài)編碼對(duì)照表
,
（3）查詢狀態(tài)編碼對(duì)照表
（4）國(guó)際地區(qū)編碼對(duì)照表(來(lái)自sao.cn)
編碼 中文名稱 AR AM AU AT BD BR BG
阿根廷 亞美尼亞 澳大利亞 奧地利 孟加拉國(guó) 巴西 保加利亞
英文名稱 Argentina Armenia Australia Austria Bangladesh Brazil Bulgaria
編碼 中文名稱 BI ZM SH GM WS TG XL
布隆迪 贊比亞 圣赫勒拿島 岡比亞 薩摩亞 多哥
新西蘭屬土島嶼
英文名稱 Burundi Zambia Saint Helena Gambia Samoa Togo
New Zealand Other Island
,KH 柬埔寨 CA 加拿大 CL 智利 CN 中國(guó) HR 克羅地亞 CY 塞浦路斯 CZ 捷克 DK 丹麥 FI 芬蘭 FR 法國(guó) DE 德國(guó) GR 希臘 IS 冰島 ID 印尼 IN 印度 IE 愛爾蘭 IL 以色列 JP 日本 JO 約旦 KR 韓國(guó) MT 馬耳他 MY 馬來(lái)西亞 MX 墨西哥 NZ 新西蘭 NO 挪威 PK 巴基斯坦 PT 葡萄牙 QA 卡塔爾 RO 羅馬尼亞 SG 新加坡 SK 斯洛伐克 ES 西班牙 CH 瑞士 TW 臺(tái)灣 TH 泰國(guó) TN 突尼斯 TR
土耳其
Cambodia Canada Chile China Croatia Cyprus Czech Denmark Finland France Germany Greece Iceland Indonesia India Ireland Israel Japan Jordan Korea Malta Malaysia Mexico New Zealand Norway Pakistan Portugal Qatar Romania Singapore Slovakia Spain Switzerland Taiwan Thailand Tunisia Turkey
ZR 扎伊爾 SC 塞舌爾 JM 牙買加 HT 海地
TC 特克斯和凱科斯群島 GQ 赤道幾內(nèi)亞 VC 圣文森特和格林納丁斯 TK 托克勞 TZ 坦桑尼亞 NR 瑙魯 AQ 南極洲 ET 埃塞俄比亞 PF 法屬玻利尼西亞 BS 巴哈馬 BM 百慕大 NE 尼日爾 BJ 貝寧
ST 圣多美和普林西比 VA 梵蒂岡 GU 關(guān)島
FX 法屬美特羅波利坦
LC Sant Lucia NA 納米比亞 DO 多米尼加共和國(guó) NF 諾福克 MK 馬其頓 XC 海峽群島 MW 馬拉維 BB 巴巴多斯島 VI 美屬維爾京群島 UM 美國(guó)本土外小島嶼 SN 塞內(nèi)加爾 SZ 斯威士蘭 TF 法屬南部領(lǐng)土 VE 委內(nèi)瑞拉 ME 黑山
WF
瓦利斯群島和富圖納群島
Zaire Seychelles Jamaica Haiti
Turks And Caicos Islands
Equatorial Guinea Saint Vincent And The Grenadines Tokelau Tanzania Nauru Antarctica Ethiopia Polynesia Bahamas Bermuda Niger Benin
Sao Tome And Principe Vatican City Guam
France Metropolitan Saint Lucia Namibia
Dominican Republic Norfolk Macedonia Channel Islands Malawi Barbados Vigin Islands United States Minor Outlying Islands Senegal Swaziland French Southern Territories Venezuela Montenegro Wallis And Futuna Islands
,AE UY US EE RU BY BA 阿聯(lián)酋 烏拉圭 美國(guó) 愛沙尼亞 俄羅斯 白俄羅斯 波黑 United Arab Emirates Uruguay America Estonia Russia White Russia KN BV CI RS SR VU 圣基茨和尼維斯 布維島 科特迪瓦 塞爾維亞 蘇里南 瓦努阿圖 圖瓦盧 Saint Kitts And Nevis Bouvet Island Cote D'ivoire Serbia Surinam Vanuatu Tuvalu Bosnia and Herzegovina TV
PL 波蘭 EC 厄瓜多爾 KZ 哈薩克斯坦LV 拉脫維亞 LB 黎巴嫩 LT 立陶宛 LU 盧森堡 PE 秘魯 SE 瑞典 SA 沙特阿拉伯SI 斯洛文尼亞UA 烏克蘭 HU 匈牙利 IT 意大利 AF 阿富汗 BO 玻利維亞 AZ 阿塞拜疆 BE 比利時(shí) CR 哥斯達(dá)尼加HK 香港 MA 摩洛哥 NG 尼日利亞 NL 荷蘭 GH 加納 PH 菲律賓 GL 格陵蘭 KG 吉爾吉斯 PY 巴拉圭 XO 科索沃 BL 巴勒斯坦 OM 阿曼 EG 埃及 VN 越南 MV
馬爾代夫
Poland Ecuador Kazakstan Latvia Lebanon Lithuania Luxemburg Peru Sweden Saudi Arabia Slovenia Ukraine Hungary Italy Afghanistan Bolivia Azerbaijan Belgium Costa Rica Hong Kong Morocco Nigeria Holand Ghana Philippines Greenland Kirghizia Paraguay Kosovo Palestine Oman Egypt Viet Nam Maldives
XF 科西嘉島 HM 赫德島和麥克唐島 MQ 馬提尼克 BT 不丹
MS 蒙特塞拉特島 MR 毛里塔尼亞 PG 巴布亞新幾內(nèi)亞 LS 萊索托 MG 馬達(dá)加斯加 DJ 吉布提 CC 科科斯群島 XD 阿森松 SO 索馬里 CV 佛得角群島 PW 帕勞群島 GI 直布羅陀 XJ 巴利阿里群島 DM 多米尼克 MC 摩納哥
XE 加沙及汗尤尼斯 BW 博茨瓦納 XG 北非西班牙屬土 GS 南喬治亞島和南桑德韋奇島 MH 馬紹爾群島 TP 東帝汶 FM 密克羅尼西亞 KI 基里巴斯 XI 馬德拉 ER 厄立特里亞 UG 烏干達(dá) GP 瓜德羅普島 GF 法屬圭亞那 CF 中非共和國(guó) CX
圣誕島
Corsica
Heard Island And Mcdonald Islands Martinique Bhutan Montserrat Mauritania Papua New Guinea Lesotho Madagascar Djibouti Cocos Islands Ascension Somalia
Cape Verde Island Palau Gibraltar Balearic Islands Dominica Monaco
Gaza And Khan Yunis Botswana
Spanish Territories Of N. Africa
South Georgia And The South Sandwich Is. Marshall Islands East Timor Micronesia Kiribati Madeira Eritrea Uganda Guadeloupe French Guiana Central Africa Christmas Island
,ZA 南非 MO 中國(guó)澳門 IQ 伊拉克 KP 北朝鮮 DZ 阿爾及利亞 UZ 烏茲別克斯坦 TJ 塔吉克斯坦 BN 文萊 LY 利比亞 CO 哥倫比亞 KW 科威特 MN 蒙古 LA 老撾 MM 緬甸 GE 格魯吉亞 IR 伊朗 SY 敘利亞 AL 阿爾巴尼亞 GB 英國(guó) PR 波多黎各 MD 摩爾多瓦 NP 尼泊爾 SV 薩爾瓦多 RE 留尼旺 GA 加蓬
SJ 斯匹次卑爾根群島 NU 紐埃 LK 斯里蘭卡 MP 馬里亞納群島 TO 湯加 LI 列支敦士登 YU 南斯拉夫 CG 剛果 AI 安圭拉 GN 新幾內(nèi)亞 XK 加羅林群島 KM 科摩羅 KY 開曼群島 BH 巴林 YE
也門
South Africa Macao Iraq North Korea Algeria Uzbekistan Tadzhikistan Brunei Libya Colombia Kuwait Mongolia Laos Burma Georgia Iran Syria Albania United Kingdom Porto Rico Moldova Nepal Salvador Reunion Gabon Spitsbergen Niue Srilanka Mariana Tonga Liechtenstein Yugoslavia Congo Anguilla Guinea
Caroline Islands Comoros Cayman Islands Bahrain Yemen
TD 乍得
AG 安提瓜和巴布達(dá) ZW 津巴布韋 HN 洪都拉斯 XB 特里斯坦 SD 蘇丹
PM 圣皮埃爾和密克隆群島 KE 肯尼亞
VG 英屬維爾京群島 PA 巴拿馬 NC 新喀里多尼亞 FO 法羅群島 SB 所羅門群島 EH 西撒哈拉 CU 古巴
TT 特立尼達(dá)和多巴哥 XM 威克島 FJ 斐濟(jì) MZ 莫桑比克 ML 馬里 GD 格林納達(dá) CK 庫(kù)克群島 CM 喀麥隆 AN 荷屬安的列斯群島 SM 圣馬力諾 BF 布基納法索 MU 毛里求斯 GT 危地馬拉 XH 亞速爾 AS 美屬薩摩亞 LR 利比里亞 GY 圭亞那 SL 塞拉利昴 FK 福克蘭群島 YT 馬約特島 AW 阿魯巴島 NI 尼加拉瓜 AD 安道爾共和國(guó) RW 盧旺達(dá) AO
安哥拉
Chadian
Antigua And Barbuda Zimbabwe Honduras
Tristan Da Cunha Sudan
Saint Pierre And Miquelon Kenya
Virgin Islands Panama New Caledonia Faroe Islands Solomon Western Sahara Cuba
Trinidad And Tobago Wake Island Fiji Mozambique Mali Grenada Cook Island Cameroon
Netherlands Antilles San Marino Burkina Faso Mauritius Guatemala Azores American Samoa Liberia Guyana Sierra Leone Falkland Island Mayotte Aruba Nicaragua Andorra Rwanda Angola
,BZ 伯利茲 Belize
GW 幾內(nèi)亞 Guinea-bissau
（5）語(yǔ)言編碼對(duì)照表(來(lái)自sao.cn) 編碼 中文名稱
AUTO 自動(dòng)檢測(cè)
EN 英語(yǔ)
ZH-CN 中文(簡(jiǎn)體)
ZH-TW 中文(繁體)
DE 德語(yǔ)
RU 俄語(yǔ)
FR 法語(yǔ)
KO 韓語(yǔ)
PT 葡萄牙語(yǔ)
JA 日語(yǔ)
ES 西班牙語(yǔ)
TH 泰語(yǔ)
SQ 阿爾巴尼亞語(yǔ)
AR 阿拉伯語(yǔ)
AZ 阿塞拜疆語(yǔ)
GA 愛爾蘭語(yǔ)
ET 愛沙尼亞語(yǔ)
BE 白俄羅斯語(yǔ)
BG 保加利亞語(yǔ)
IS 冰島語(yǔ)
PL 波蘭語(yǔ)
FA 波斯語(yǔ)
AF 布爾文(南非荷蘭語(yǔ)) DA 丹麥語(yǔ)
TL 菲律賓語(yǔ)
FI 芬蘭語(yǔ)
KA 格魯吉亞語(yǔ)
GU 古吉拉特語(yǔ)
HT 海地克里奧爾語(yǔ) NL 荷蘭語(yǔ)
GL 加利西亞語(yǔ)
CA 加泰羅尼亞語(yǔ)
CS 捷克語(yǔ)
HR 克羅地亞語(yǔ)
LA 拉丁語(yǔ)
LV 拉脫維亞語(yǔ)
LT 立陶宛語(yǔ) TM 土庫(kù)曼斯坦 Turkmenistan 英文名稱 Auto Detect English Chinese(Simplified) Chinese(Traditional) German Russian French Korean Portuguese Japanese Spanish Thai Albanian Arabic Azerbaijani Irish Estonian Belarusian Bulgarian Icelandic Polish Persian Afrikaans Danish Filipino Finnish Georgian Gujarati Haitian Creole Dutch Galician Catalan Czech Croatian Latin Latvian Lithuanian
,RO
MT
MS
MK
NO
SV
SR
SK
SL
SW
TR
CY
UK
IW
EL
EU
HU
HY
IT
YI
HI
KN
TE
TA
UR
ID
VI 羅馬尼亞語(yǔ) 馬耳他語(yǔ) 馬來(lái)語(yǔ) 馬其頓語(yǔ) 挪威語(yǔ) 瑞典語(yǔ) 塞爾維亞語(yǔ) 斯洛伐克語(yǔ) 斯洛文尼亞語(yǔ) 斯瓦希里語(yǔ) 土耳其語(yǔ) 威爾士語(yǔ) 烏克蘭語(yǔ) 希伯來(lái)語(yǔ) 希臘語(yǔ) 西班牙的巴斯克語(yǔ) 匈牙利語(yǔ) 亞美尼亞語(yǔ) 意大利語(yǔ) 意第緒語(yǔ) 印地語(yǔ) 印度的卡納達(dá)語(yǔ) 印度的泰盧固語(yǔ) 印度的泰米爾語(yǔ) 印度烏爾都語(yǔ) 印尼語(yǔ) 越南語(yǔ) Romanian Maltese Malay Macedonian Norwegian Swedish Serbian Slovak Slovenian Swahili Turkish Welsh Ukrainian Hebrew Greek Basque Hungarian Armenian Italian Yiddish Hindi Kannada Telugu Tamil Urdu Indonesian Vietnamese
四、接口報(bào)文
（1）郵包查詢返回XML 示例