收貨地址共享接口
功能簡介
1、簡介
微信收貨地址共享,是指用戶在微信瀏覽器內(nèi)打開網(wǎng)頁,填寫過地址后,后續(xù)可以免填寫支持快速選擇,也可增加和編輯。
此地址為用戶屬性,可在各商戶的網(wǎng)頁中共享使用。支持原生控件填寫地址,地址數(shù)據(jù)會(huì)傳遞到商戶。
2、功能支持
地址共享是基于微信JavaScript API 實(shí)現(xiàn),只能在微信內(nèi)置瀏覽器中使用,其他瀏覽器調(diào)用無效。同時(shí),需要微信5.0 版本才能支持,建議通過user agent 來確定用戶當(dāng)前的版本號(hào)后再調(diào)用地址接口。
以iPhone 版本為例,可以通過useragent可獲取如下微信版本示例信息:"Mozilla/5.0(iphone;CPU iphone OS 5_1_1 like Mac OS X)AppleWebKit/534.46(KHTML,like Geocko) Mobile/9B206MicroMessenger/5.0"其中5.0 為用戶安裝的微信版本號(hào),商戶可以判定版本號(hào)是否高于或者等于5.0。
3、地址格式
微信地址共享使用的數(shù)據(jù)字段包括:
- 收貨人姓名
- 地區(qū),省市區(qū)三級(jí)
- 詳細(xì)地址
- 郵編
- 聯(lián)系電話
其中,地區(qū)對應(yīng)是國標(biāo)三級(jí)地區(qū)碼,如“廣東省-廣州市-天河區(qū)”,對應(yīng)的郵編是是510630。詳情參考鏈接:http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/201401/t20140116_501070.html
接口說明
編輯并獲取用戶收貨地址需以JS-SDK方式調(diào)用,在網(wǎng)頁前端調(diào)用。JS-SDK調(diào)用步驟見說明文檔(http://mp.weixin.qq.com/wiki/11/74ad127cc054f6b80759c40f77ec03db.html),需按文檔要求完成調(diào)用。
特別注意:JS-SDK版本需使用http://res.wx.qq.com/open/js/jweixin-1.1.0.js
代碼示例wx.openAddress({
success: function () {
// 用戶成功拉出地址 },
cancel: function () {
// 用戶取消拉出地址
}});
返回說明
返回值 |
說明 |
---|---|
errMsg |
獲取編輯收貨地址成功返回“openAddress:ok”。 |
userName |
收貨人姓名。 |
postalCode |
郵編。 |
provinceName |
國標(biāo)收貨地址第一級(jí)地址(省)。 |
cityName |
國標(biāo)收貨地址第二級(jí)地址(市)。 |
countryName |
國標(biāo)收貨地址第三級(jí)地址(國家)。 |
detailInfo |
詳細(xì)收貨地址信息。 |
nationalCode |
收貨地址國家碼。 |