粉絲 · we7微信API

### fansAll() - 獲取粉絲列表 ### 說明 ``` fansAll($startopenid =‘’) ``` ### 參數 - **$startopenid** 第一個拉取的OPENID，不填默認從頭開始拉取 ### 返回值 #### error error()結構的錯誤； #### success ``` $return = array( 'total' => '1000', //關注該公眾賬號的總用戶數 'fans' => array('OPENID1', 'openid2'), //列表數據，OPENID的列表 'next' => 'OPENID100', //拉取列表的最后一個用戶的OPENID ); ``` ### 示例 ``` $account_api = WeAccount::create(); $fans_list = $account_api->fansAll(); // $fans_list = array( 'total' => '1000', 'fans' => array( 'aFffAwx7D6Q0uZPRl_Riy3cEAs5s', 'aFffAw9Qwhc8MRXBDytU2JuynD5k' ), 'next' => 'aFffAw9Qwhc8MRXBDytU2JuynD5k', ); ``` ### fansQueryInfo() - 獲取粉絲列表 ### 說明 ``` fansQueryInfo($uniid) ``` ### 參數 - **$uniid** 粉絲openid ### 返回值 #### error 'error'字符串或 error()結構的錯誤； #### success ``` $return = array( "subscribe": 1, //用戶是否訂閱該公眾號標識，值為0時，代表此用戶沒有關注該公眾號，拉取不到其余信息。 "openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M", //用戶的標識，對當前公眾號唯一 "nickname": "Band", //用戶的昵稱 "sex": 1, //用戶的性別，值為1時是男性，值為2時是女性，值為0時是未知 "language": "zh_CN", //用戶的語言，簡體中文為zh_CN "city": "廣州", //用戶所在城市 "province": "廣東", //用戶所在省份 "country": "中國", //用戶所在國家 "headimgurl":"http://wx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/0",//用戶頭像，最后一個數值代表正方形頭像大小（有0、46、64、96、132數值可選，0代表640*640正方形頭像），用戶沒有頭像時該項為空。若用戶更換頭像，原有頭像URL將失效 "subscribe_time": 1382694957,//用戶關注時間，為時間戳。如果用戶曾多次關注，則取最后關注時間 "unionid": " o6_bmasdasdsad6_2sgVt7hMZOPfL"//只有在用戶將公眾號綁定到微信開放平臺帳號后，才會出現該字段。 "remark": "",//公眾號運營者對粉絲的備注，公眾號運營者可在微信公眾平臺用戶管理界面對粉絲添加備注 "groupid": 0,//用戶所在的分組ID（兼容舊的用戶分組接口） "tagid_list":[128,2]//用戶被打上的標簽ID列表 ); ``` ### 示例 ``` $account_api = WeAccount::create(); $fans_info = $account_api->fansQueryInfo('o6_bmjrPTlm6_2sgVt7hMZOPfL2M'); ``` ### fansBatchQueryInfo() - 批量獲取粉絲信息 ### 說明 ``` fansBatchQueryInfo($data) ``` ### 參數 - **$data** 要查詢的粉絲openid數組 * $data = array( * 'openid' => 'o6_bmjrPTlm6_2sgVt7hMZOPfL2M', * 'openid' => 'o6_bmjrPTlm6_2sgVt7hMZOPfL3O', * ); ### 返回值 #### error error()結構的錯誤； #### success ``` $return = array( '0' => array( "subscribe": 1, //用戶是否訂閱該公眾號標識，值為0時，代表此用戶沒有關注該公眾號，拉取不到其余信息。 "openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M", //用戶的標識，對當前公眾號唯一 "nickname": "Band", //用戶的昵稱 "sex": 1, //用戶的性別，值為1時是男性，值為2時是女性，值為0時是未知 "language": "zh_CN", //用戶的語言，簡體中文為zh_CN "city": "廣州", //用戶所在城市 "province": "廣東", //用戶所在省份 "country": "中國", //用戶所在國家 "headimgurl":"http://wx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/0",//用戶頭像，最后一個數值代表正方形頭像大小（有0、46、64、96、132數值可選，0代表640*640正方形頭像），用戶沒有頭像時該項為空。若用戶更換頭像，原有頭像URL將失效 "subscribe_time": 1382694957,//用戶關注時間，為時間戳。如果用戶曾多次關注，則取最后關注時間 "unionid": " o6_bmasdasdsad6_2sgVt7hMZOPfL"//只有在用戶將公眾號綁定到微信開放平臺帳號后，才會出現該字段。 "remark": "",//公眾號運營者對粉絲的備注，公眾號運營者可在微信公眾平臺用戶管理界面對粉絲添加備注 "groupid": 0,//用戶所在的分組ID（兼容舊的用戶分組接口） "tagid_list":[128,2]//用戶被打上的標簽ID列表 ), '1' => array( "subscribe": 0, //粉絲未關注返回此結構 "openid": "otvxTs_JZ6SEiP0imdhpi50fuSZg" ) ); ``` ### 示例 ``` $account_api = WeAccount::create(); $fans_list = $account_api->fansBatchQueryInfo(array('o6_bmjrPTlm6_2sgVt7hMZOPfL3O', 'o6_bmjrPTlm6_2sgVt7hLJSAfL56')); ```