国际邮政包裹查询网
国际邮政包裹查询网查询API 接口技术文档一、接口功能输入国际邮包单号，输出邮包的最新事件，投递状态。采用http 请求方式，支持xml 、json 、base64、txt 、map 、jsonp 等
国际邮政包裹查询网
查询API 接口技术文档
一、接口功能
输入国际邮包单号，输出邮包的最新事件，投递状态。
采用http 请求方式，支持xml 、json 、base64、txt 、map 、jsonp 等六种数据类型的返回。
备注：
1. 返回结果每天都会更新，建议不要cache 数据，以免引起错误。
2. 建议每天实时调用本接口数据来进行目标系统的邮包投递信息的更新。
二、接口使用
（1）接口概述
a. 邮包查询主接口:
b. 文字翻译辅助接口
本API 的正式域名为：api.sao.cn ；
（2）接口统一请求方式
采用HTTP 请求方式。 GET, POST均可以。
（3）邮包查询输入参数说明
（4）邮包查询请求示例
(1). 返回JSON 数据
(2). 返回XML 数据
(3). 返回TXT 文本
（5）邮包查询输出参数说明
（6）邮包查询输出示例
a. 邮包查询返回XML 示例
b. 邮包查询返回JSON 示例
c. 邮包查询返回TXT 示例
d. 邮包查询返回Map 示例
e. 邮包查询返回Base64示例
f. 邮包查询返回Base64示例
如传入参数type=jsonp_mailinfo
则返回 var jsonp_mailinfo = {JSON数据} ; mailinfo 是任意的名字
g. 邮包查询返回Base64示例
如传入参数type=callback_fuc
则返回 callback_fuc( {JSON数据} ) ; fuc 是任意的名字
（7）文字翻译输入参数说明
,
（8）文字翻译请求示例
(a). 返回Txt 数据
（9）文字翻译输出参数说明
(a) 直接输入翻译后的文本, 采用UTF-8编码。
三、接口编码对照表
（1）邮包类型编码对照表
（2）邮包状态编码对照表
,
（3）查询状态编码对照表
（4）国际地区编码对照表(来自sao.cn)
编码 中文名称 AR AM AU AT BD BR BG
阿根廷 亚美尼亚 澳大利亚 奥地利 孟加拉国 巴西 保加利亚
英文名称 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 中国 HR 克罗地亚 CY 塞浦路斯 CZ 捷克 DK 丹麦 FI 芬兰 FR 法国 DE 德国 GR 希腊 IS 冰岛 ID 印尼 IN 印度 IE 爱尔兰 IL 以色列 JP 日本 JO 约旦 KR 韩国 MT 马耳他 MY 马来西亚 MX 墨西哥 NZ 新西兰 NO 挪威 PK 巴基斯坦 PT 葡萄牙 QA 卡塔尔 RO 罗马尼亚 SG 新加坡 SK 斯洛伐克 ES 西班牙 CH 瑞士 TW 台湾 TH 泰国 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 赤道几内亚 VC 圣文森特和格林纳丁斯 TK 托克劳 TZ 坦桑尼亚 NR 瑙鲁 AQ 南极洲 ET 埃塞俄比亚 PF 法属玻利尼西亚 BS 巴哈马 BM 百慕大 NE 尼日尔 BJ 贝宁
ST 圣多美和普林西比 VA 梵蒂冈 GU 关岛
FX 法属美特罗波利坦
LC Sant Lucia NA 纳米比亚 DO 多米尼加共和国 NF 诺福克 MK 马其顿 XC 海峡群岛 MW 马拉维 BB 巴巴多斯岛 VI 美属维尔京群岛 UM 美国本土外小岛屿 SN 塞内加尔 SZ 斯威士兰 TF 法属南部领土 VE 委内瑞拉 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 阿联酋 乌拉圭 美国 爱沙尼亚 俄罗斯 白俄罗斯 波黑 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 比利时 CR 哥斯达尼加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 巴布亚新几内亚 LS 莱索托 MG 马达加斯加 DJ 吉布提 CC 科科斯群岛 XD 阿森松 SO 索马里 CV 佛得角群岛 PW 帕劳群岛 GI 直布罗陀 XJ 巴利阿里群岛 DM 多米尼克 MC 摩纳哥
XE 加沙及汗尤尼斯 BW 博茨瓦纳 XG 北非西班牙属土 GS 南乔治亚岛和南桑德韦奇岛 MH 马绍尔群岛 TP 东帝汶 FM 密克罗尼西亚 KI 基里巴斯 XI 马德拉 ER 厄立特里亚 UG 乌干达 GP 瓜德罗普岛 GF 法属圭亚那 CF 中非共和国 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 中国澳门 IQ 伊拉克 KP 北朝鲜 DZ 阿尔及利亚 UZ 乌兹别克斯坦 TJ 塔吉克斯坦 BN 文莱 LY 利比亚 CO 哥伦比亚 KW 科威特 MN 蒙古 LA 老挝 MM 缅甸 GE 格鲁吉亚 IR 伊朗 SY 叙利亚 AL 阿尔巴尼亚 GB 英国 PR 波多黎各 MD 摩尔多瓦 NP 尼泊尔 SV 萨尔瓦多 RE 留尼旺 GA 加蓬
SJ 斯匹次卑尔根群岛 NU 纽埃 LK 斯里兰卡 MP 马里亚纳群岛 TO 汤加 LI 列支敦士登 YU 南斯拉夫 CG 刚果 AI 安圭拉 GN 新几内亚 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 安提瓜和巴布达 ZW 津巴布韦 HN 洪都拉斯 XB 特里斯坦 SD 苏丹
PM 圣皮埃尔和密克隆群岛 KE 肯尼亚
VG 英属维尔京群岛 PA 巴拿马 NC 新喀里多尼亚 FO 法罗群岛 SB 所罗门群岛 EH 西撒哈拉 CU 古巴
TT 特立尼达和多巴哥 XM 威克岛 FJ 斐济 MZ 莫桑比克 ML 马里 GD 格林纳达 CK 库克群岛 CM 喀麦隆 AN 荷属安的列斯群岛 SM 圣马力诺 BF 布基纳法索 MU 毛里求斯 GT 危地马拉 XH 亚速尔 AS 美属萨摩亚 LR 利比里亚 GY 圭亚那 SL 塞拉利昴 FK 福克兰群岛 YT 马约特岛 AW 阿鲁巴岛 NI 尼加拉瓜 AD 安道尔共和国 RW 卢旺达 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 几内亚 Guinea-bissau
（5）语言编码对照表(来自sao.cn) 编码 中文名称
AUTO 自动检测
EN 英语
ZH-CN 中文(简体)
ZH-TW 中文(繁体)
DE 德语
RU 俄语
FR 法语
KO 韩语
PT 葡萄牙语
JA 日语
ES 西班牙语
TH 泰语
SQ 阿尔巴尼亚语
AR 阿拉伯语
AZ 阿塞拜疆语
GA 爱尔兰语
ET 爱沙尼亚语
BE 白俄罗斯语
BG 保加利亚语
IS 冰岛语
PL 波兰语
FA 波斯语
AF 布尔文(南非荷兰语) DA 丹麦语
TL 菲律宾语
FI 芬兰语
KA 格鲁吉亚语
GU 古吉拉特语
HT 海地克里奥尔语 NL 荷兰语
GL 加利西亚语
CA 加泰罗尼亚语
CS 捷克语
HR 克罗地亚语
LA 拉丁语
LV 拉脱维亚语
LT 立陶宛语 TM 土库曼斯坦 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 罗马尼亚语 马耳他语 马来语 马其顿语 挪威语 瑞典语 塞尔维亚语 斯洛伐克语 斯洛文尼亚语 斯瓦希里语 土耳其语 威尔士语 乌克兰语 希伯来语 希腊语 西班牙的巴斯克语 匈牙利语 亚美尼亚语 意大利语 意第绪语 印地语 印度的卡纳达语 印度的泰卢固语 印度的泰米尔语 印度乌尔都语 印尼语 越南语 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
四、接口报文
（1）邮包查询返回XML 示例