微信公衆號UnionId機制

獲取用戶基本信息(UnionID機制)api

在關注者與公衆號產生消息交互後，公衆號可得到關注者的OpenID（加密後的微信號，每一個用戶對每一個公衆號的OpenID是惟一的。對於不一樣公衆號，同一用戶的openid不一樣）。公衆號可經過本接口來根據OpenID獲取用戶基本信息，包括暱稱、頭像、性別、所在城市、語言和關注時間。微信

請注意，若是開發者有在多個公衆號，或在公衆號、移動應用之間統一用戶賬號的需求，須要前往微信開放平臺（open.weixin.qq.com）綁定公衆號後，纔可利用UnionID機制來知足上述需求。app

UnionID機制說明：微信公衆平臺

開發者可經過OpenID來獲取用戶基本信息。特別須要注意的是，若是開發者擁有多個移動應用、網站應用和公衆賬號，可經過獲取用戶基本信息中的unionid來區分用戶的惟一性，由於只要是同一個微信開放平臺賬號下的移動應用、網站應用和公衆賬號，用戶的unionid是惟一的。換句話說，同一用戶，對同一個微信開放平臺下的不一樣應用，unionid是相同的。網站

獲取用戶基本信息（包括UnionID機制）ui

開發者可經過OpenID來獲取用戶基本信息。請使用https協議。加密

接口調用請求說明
http請求方式: GET
https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN

參數說明url

參數	是否必須	說明
access_token	是	調用接口憑證
openid	是	普通用戶的標識，對當前公衆號惟一
lang	否	返回國家地區語言版本，zh_CN 簡體，zh_TW 繁體，en 英語

返回說明spa

正常狀況下，微信會返回下述JSON數據包給公衆號：code

{
    "subscribe": 1, 
    "openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M", 
    "nickname": "Band", 
    "sex": 1, 
    "language": "zh_CN", 
    "city": "廣州", 
    "province": "廣東", 
    "country": "中國", 
    "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": ""
}

參數說明

參數	說明
subscribe	用戶是否訂閱該公衆號標識，值爲0時，表明此用戶沒有關注該公衆號，拉取不到其他信息。
openid	用戶的標識，對當前公衆號惟一
nickname	用戶的暱稱
sex	用戶的性別，值爲1時是男性，值爲2時是女性，值爲0時是未知
city	用戶所在城市
country	用戶所在國家
province	用戶所在省份
language	用戶的語言，簡體中文爲zh_CN
headimgurl	用戶頭像，最後一個數值表明正方形頭像大小（有0、4六、6四、9六、132數值可選，0表明640*640正方形頭像），用戶沒有頭像時該項爲空。若用戶更換頭像，原有頭像URL將失效。
subscribe_time	用戶關注時間，爲時間戳。若是用戶曾屢次關注，則取最後關注時間
unionid	只有在用戶將公衆號綁定到微信開放平臺賬號後，纔會出現該字段。
remark	公衆號運營者對粉絲的備註，公衆號運營者可在微信公衆平臺用戶管理界面對粉絲添加備註
groupid	用戶所在的分組ID（兼容舊的用戶分組接口）
tagid_list	用戶被打上的標籤ID列表
subscribe_scene	返回用戶關注的渠道來源，ADD_SCENE_SEARCH 公衆號搜索，ADD_SCENE_ACCOUNT_MIGRATION 公衆號遷移，ADD_SCENE_PROFILE_CARD 名片分享，ADD_SCENE_QR_CODE 掃描二維碼，ADD_SCENEPROFILE LINK 圖文頁內名稱點擊，ADD_SCENE_PROFILE_ITEM 圖文頁右上角菜單，ADD_SCENE_PAID 支付後關注，ADD_SCENE_OTHERS 其餘
qr_scene	二維碼掃碼場景（開發者自定義）
qr_scene_str	二維碼掃碼場景描述（開發者自定義）

錯誤時微信會返回錯誤碼等信息，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": "otvxTs4dckWG7imySrJd6jSi0CWE", 
            "lang": "zh_CN"
        }, 
        {
            "openid": "otvxTs_JZ6SEiP0imdhpi50fuSZg", 
            "lang": "zh_CN"
        }
    ]
}

參數說明

參數	是否必須	說明
openid	是	用戶的標識，對當前公衆號惟一
lang	否	國家地區語言版本，zh_CN 簡體，zh_TW 繁體，en 英語，默認爲zh-CN

返回說明

正常狀況下，微信會返回下述JSON數據包給公衆號（示例中爲一次性拉取了2個openid的用戶基本信息，第一個是已關注的，第二個是未關注的）：

{
   "user_info_list": [
       {
           "subscribe": 1, 
           "openid": "otvxTs4dckWG7imySrJd6jSi0CWE", 
           "nickname": "iWithery", 
           "sex": 1, 
           "language": "zh_CN", 
           "city": "揭陽", 
           "province": "廣東", 
           "country": "中國", 

           "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"
       }
   ]
}

參數說明

參數	說明
subscribe	用戶是否訂閱該公衆號標識，值爲0時，表明此用戶沒有關注該公衆號，拉取不到其他信息，只有openid和UnionID（在該公衆號綁定到了微信開放平臺帳號時纔有）。
openid	用戶的標識，對當前公衆號惟一
nickname	用戶的暱稱
sex	用戶的性別，值爲1時是男性，值爲2時是女性，值爲0時是未知
city	用戶所在城市
country	用戶所在國家
province	用戶所在省份
language	用戶的語言，簡體中文爲zh_CN
headimgurl	用戶頭像，最後一個數值表明正方形頭像大小（有0、4六、6四、9六、132數值可選，0表明640*640正方形頭像），用戶沒有頭像時該項爲空。若用戶更換頭像，原有頭像URL將失效。
subscribe_time	用戶關注時間，爲時間戳。若是用戶曾屢次關注，則取最後關注時間
unionid	只有在用戶將公衆號綁定到微信開放平臺賬號後，纔會出現該字段。
remark	公衆號運營者對粉絲的備註，公衆號運營者可在微信公衆平臺用戶管理界面對粉絲添加備註
groupid	用戶所在的分組ID（暫時兼容用戶分組舊接口）
tagid_list	用戶被打上的標籤ID列表
subscribe_scene	返回用戶關注的渠道來源，ADD_SCENE_SEARCH 公衆號搜索，ADD_SCENE_ACCOUNT_MIGRATION 公衆號遷移，ADD_SCENE_PROFILE_CARD 名片分享，ADD_SCENE_QR_CODE 掃描二維碼，ADD_SCENEPROFILE LINK 圖文頁內名稱點擊，ADD_SCENE_PROFILE_ITEM 圖文頁右上角菜單，ADD_SCENE_PAID 支付後關注，ADD_SCENE_OTHERS 其餘
qr_scene	二維碼掃碼場景（開發者自定義）
qr_scene_str	二維碼掃碼場景描述（開發者自定義）

錯誤時微信會返回錯誤碼等信息，JSON數據包示例以下（該示例爲AppID無效錯誤）:

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