取得用戶基本資訊(UnionID機制)

取得使用者基本資訊(UnionID機制)

在追蹤者與公眾號產生訊息互動後，公眾號可獲得追蹤者的OpenID（加密後的微訊號，每個使用者對每個公眾號的OpenID是唯一的。對於不同公眾號，同一使用者的openid不同）。公眾號可透過此介面來根據OpenID取得使用者基本資訊，包括暱稱、頭像、性別、所在城市、語言和關注時間。

請注意，如果開發者有在多個公眾號，或在公眾號、行動應用程式之間統一使用者帳號的需求，需要前往微信開放平台（open.weixin.qq.com）綁定公眾號後，才可利用UnionID機制來滿足上述需求。

UnionID機制說明：

開發者可透過OpenID來取得使用者基本資訊。特別要注意的是，如果開發者擁有多個行動應用程式、網站應用程式和公眾帳號，可透過取得使用者基本資訊中的unionid來區分使用者的唯一性，因為只要是同一個微信開放平台帳號下的行動應用、網站應用程式和公眾帳號，使用者的unionid是唯一的。換句話說，同一用戶，對同一個微信開放平台下的不同應用，unionid是相同的。

取得使用者基本資訊（包含UnionID機制）

開發者可透過OpenID來取得使用者基本資訊。請使用https協議。

介面呼叫請求說明

http要求方式: GET https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang= zh_CN

參數說明

參數	是否必須	說明
access_token	是	呼叫介面憑證
openid	是	一般使用者的標識，對目前公眾號碼唯一
lang	否	返回國家地區語言版本，zh_CN 簡體，zh_TW 繁體，en 英文

回傳說明

正常情況下，微信會回傳下述JSON封包給公號：

{
"subscribe": 1,
"openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",
"nickname": "Band",
"sex": 1,
"lanage": "zh_CN",#city # province": "廣東",
"country": "中國",

"headimgurl": "http://wx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4

eMsv84eavHiaiceqxibJxCfHe/ 0",

"subscribe_time": 1382694957,

"unionid": " o6_bmasdasdsad6_2sgVt7hMZOPfL"

"remark": "",

"tagid_list":[128,2]
}

參數說明

##headimgurl使用者頭像，最後一個數值代表正方形頭像大小（有0、46、64、96、132數值可選，0代表640*640正方形頭像），使用者沒有頭像時該項為空。若用戶更換頭像，原有頭像URL將失效。

參數	說明
#subscribe	使用者是否訂閱該公眾號標識，值為0時，代表此用戶沒有關注該公眾號，拉取不到其餘資訊。
openid	使用者的標識，對目前公眾號碼唯一
nickname	#使用者的暱稱
sex	使用者的性別，值為1時是男性，值為2時是女性，值為0時是未知
city	用戶所在城市
country	用戶所在國家
province	使用者所在省份
language	使用者的語言，簡體中文為zh_CN

subscribe_time	使用者關注時間，為時間戳記。如果用戶曾多次關注，則取最後關注時間
unionid	#只有在用戶將公眾號綁定到微信開放平台帳號後，才會出現該字段。
remark	公眾號經營者對粉絲的備註，公眾號經營者可在微信公眾平台用戶管理介面對粉絲添加備註
groupid	使用者所在的分組ID（相容於舊的使用者分組介面）
tagid_list	使用者被打上的標籤ID列表

錯誤時微信會傳回錯誤碼等訊息，JSON封包範例如下（範例為AppID無效錯誤）:

{"errcode":40013,"errmsg":"invalid appid"}

批次取得使用者基本資訊

開發者可透過此介面來大量取得使用者基本資訊。最多支援一次拉取100條。

介面呼叫請求說明

http要求方式: POST

#https://api.weixin.qq.com/cgi-bin/user/info/ batchget?access_token=ACCESS_TOKEN

POST資料範例

{
"user_list": [
{
"openid": "otvxTs4dWG7imySrWEd6: SiCpWEid CN"
},
{
"openid": "otvxTs_JZ6SEiP0imdhpi }
]
}

參數說明

##說明openid是使用者的標識，對目前公眾號唯一lang否#國家地區語言版本，zh_CN 簡體，zh_TW 繁體，en 英語，預設為zh-CN

參數	是否必須

###

回傳說明

正常情況下，微信會傳回下述JSON封包給公眾號（範例中為一次拉取了2個openid的使用者基本信息，第一個是已關注的，第二個是未關注的）：

{
"user_info_list": [
{
"subscribe": 1, ## WG ## "nickname": "iWithery",
"sex": 1,
與 "province": "Guangdong ",
"country": "China",

"headimgurl": "http://wx.qlogo.cn/mmopen/xbIQx1GRqvyNCCD54520FFyFFy n550500P4P4000P4000P40P4000P400050P4050P4050P4050P4000550P4050505050 B7p8XHXIf6uJA2SCun

TPicGKezDC4saKISzRj3nz/0",
"subscribe_time": 1434093047,

"unionid": "oR5GjjgEhCMJFyzaVZ為xZ2zRRF4", # "groupid": 0,

"tagid_list": [128,2]

},
{
"subscribe": 0,

subscribe": 0,

"unionid": "oR5GjjjrbqBZbrnPwwmSxFukE41U",

}
]

}
#

參數說明

參數	說明
#subscribe	使用者是否訂閱該公眾號標識，值為0時，代表此用戶沒有關注該公眾號，拉取不到其餘信息，只有openid和UnionID（在該公眾號綁定到了微信開放平台帳號時才有）。
openid	使用者的標識，對目前公眾號碼唯一
nickname	#使用者的暱稱
sex	使用者的性別，值為1時是男性，值為2時是女性，值為0時是未知
city	用戶所在城市
country	用戶所在國家
province	使用者所在省份
language	使用者的語言，簡體中文為zh_CN

subscribe_time	使用者關注時間，為時間戳記。如果用戶曾多次關注，則取最後關注時間
unionid	#只有在用戶將公眾號綁定到微信開放平台帳號後，才會出現該字段。
remark	公眾號經營者對粉絲的備註，公眾號經營者可在微信公眾平台用戶管理介面對粉絲添加備註
groupid	使用者所在的分組ID（暫時相容使用者分組舊介面）
#tagid_list	使用者被打上的標籤ID列表

錯誤時微信會傳回錯誤碼等訊息，JSON封包範例如下（範例為AppID無效錯誤）:

{"errcode":40013,"errmsg":"invalid appid "}

############# #### ######

← 設定用戶備註名

取得使用者列表 →

取得用戶基本資訊(UnionID機制)

取得使用者基本資訊(UnionID機制)

PHP中文網