獲取微信公眾號(hào)用戶(hù)的基本信息(UnionID機(jī)制)

在關(guān)注者與公眾號(hào)產(chǎn)生消息交互后，公眾號(hào)可獲得關(guān)注者的OpenID（加密后的微信號(hào)，每個(gè)用戶(hù)對(duì)每個(gè)公眾號(hào)的OpenID是唯一的。對(duì)于不同公眾號(hào)，同一用戶(hù)的openid不同）。公眾號(hào)可通過(guò)本接口來(lái)根據(jù)OpenID獲取用戶(hù)基本信息，包括昵稱(chēng)、頭像、性別、所在城市、語(yǔ)言和關(guān)注時(shí)間。

請(qǐng)注意，如果開(kāi)發(fā)者有在多個(gè)公眾號(hào)，或在公眾號(hào)、移動(dòng)應(yīng)用之間統(tǒng)一用戶(hù)帳號(hào)的需求，需要前往微信開(kāi)放平臺(tái)（open.weixin.qq.com）綁定公眾號(hào)后，才可利用UnionID機(jī)制來(lái)滿(mǎn)足上述需求。

UnionID機(jī)制說(shuō)明：

開(kāi)發(fā)者可通過(guò)OpenID來(lái)獲取用戶(hù)基本信息。特別需要注意的是，如果開(kāi)發(fā)者擁有多個(gè)移動(dòng)應(yīng)用、網(wǎng)站應(yīng)用和公眾帳號(hào)，可通過(guò)獲取用戶(hù)基本信息中的unionid來(lái)區(qū)分用戶(hù)的唯一性，因?yàn)橹灰峭粋€(gè)微信開(kāi)放平臺(tái)帳號(hào)下的移動(dòng)應(yīng)用、網(wǎng)站應(yīng)用和公眾帳號(hào)，用戶(hù)的unionid是唯一的。換句話說(shuō)，同一用戶(hù)，對(duì)同一個(gè)微信開(kāi)放平臺(tái)下的不同應(yīng)用，unionid是相同的。

請(qǐng)注意： 20年6月8日起，用戶(hù)關(guān)注來(lái)源“微信廣告（ADD_SCENE_WECHAT_ADVERTISEMENT）”從“其他（ADD_SCENE_OTHERS）”中拆分給出。

獲取用戶(hù)基本信息（包括UnionID機(jī)制）

開(kāi)發(fā)者可通過(guò)OpenID來(lái)獲取用戶(hù)基本信息。請(qǐng)使用https協(xié)議。

接口調(diào)用請(qǐng)求說(shuō)明 http請(qǐng)求方式: GET https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN

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

返回說(shuō)明

正常情況下，微信會(huì)返回下述JSON數(shù)據(jù)包給公眾號(hào)：

{
    "subscribe": 1, 
    "openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M", 
    "nickname": "Band", 
    "sex": 1, 
    "language": "zh_CN", 
    "city": "廣州", 
    "province": "廣東", 
    "country": "中國(guó)", 
    "headimgurl":"http://thirdwx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/0",
    "subscribe_time": 1382694957,
    "unionid": " o6_bmasdasdsad6_2sgVt7hMZOPfL"
    "remark": "",
    "groupid": 0,
    "tagid_list":[128,2],
    "subscribe_scene": "ADD_SCENE_QR_CODE",
    "qr_scene": 98765,
    "qr_scene_str": ""
}

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

錯(cuò)誤時(shí)微信會(huì)返回錯(cuò)誤碼等信息，JSON數(shù)據(jù)包示例如下（該示例為AppID無(wú)效錯(cuò)誤）:

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

批量獲取用戶(hù)基本信息

開(kāi)發(fā)者可通過(guò)該接口來(lái)批量獲取用戶(hù)基本信息。最多支持一次拉取100條。

接口調(diào)用請(qǐng)求說(shuō)明

http請(qǐng)求方式: POST https://api.weixin.qq.com/cgi-bin/user/info/batchget?access_token=ACCESS_TOKEN

POST數(shù)據(jù)示例

{
    "user_list": [
        {
            "openid": "otvxTs4dckWG7imySrJd6jSi0CWE", 
            "lang": "zh_CN"
        }, 
        {
            "openid": "otvxTs_JZ6SEiP0imdhpi50fuSZg", 
            "lang": "zh_CN"
        }
    ]
}

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

返回說(shuō)明

正常情況下，微信會(huì)返回下述JSON數(shù)據(jù)包給公眾號(hào)（示例中為一次性拉取了2個(gè)openid的用戶(hù)基本信息，第一個(gè)是已關(guān)注的，第二個(gè)是未關(guān)注的）：

{
   "user_info_list": [
       {
           "subscribe": 1, 
           "openid": "otvxTs4dckWG7imySrJd6jSi0CWE", 
           "nickname": "iWithery", 
           "sex": 1, 
           "language": "zh_CN", 
           "city": "揭陽(yáng)", 
           "province": "廣東", 
           "country": "中國(guó)", 

           "headimgurl": "http://thirdwx.qlogo.cn/mmopen/xbIQx1GRqdvyqkMMhEaGOX802l1CyqMJNgUzKP8MeAeHFicRDSnZH7FY4XB7p8XHXIf6uJA2SCunTPicGKezDC4saKISzRj3nz/0",

          "subscribe_time": 1434093047, 
           "unionid": "oR5GjjgEhCMJFyzaVZdrxZ2zRRF4", 
           "remark": "", 

           "groupid": 0,
           "tagid_list":[128,2],
           "subscribe_scene": "ADD_SCENE_QR_CODE",
           "qr_scene": 98765,
           "qr_scene_str": ""

      }, 
       {
           "subscribe": 0, 
           "openid": "otvxTs_JZ6SEiP0imdhpi50fuSZg"
       }
   ]
}

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

錯(cuò)誤時(shí)微信會(huì)返回錯(cuò)誤碼等信息，JSON數(shù)據(jù)包示例如下（該示例為AppID無(wú)效錯(cuò)誤）:

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