公众号可通过本接口来获取帐号的关注者列表，关注者列表由一串openid（每个用户对每个公众号的openid是唯一的）组成。一次拉取调用最多拉取10000个关注者的OpenID，可以通过多次拉取的方式来满足需求。

目录

[隐藏]1请求说明

2请求参数

3返回说明

4返回参数

5异常返回说明

请求说明

http请求方式:GET

https://api.yixin.im/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=next_openid

请求参数

参数是否必须描述

access_token是调用接口凭证

next_openid否第一个拉取的openid不填默认从头开始拉取

返回说明

附：关注者数量超过10000时

公众账号A拥有22010个关注的人，想通过拉取关注接口获取所有关注的人，那么分别请求url如下：

https://api.yixin.im/cgi-bin/user/get?access_token=ACCESS_TOKEN

{

"total":22010,

"count":10000,

"data":{

"openid":[

"OPENID1",

"OPENID2",

...,

"OPENID10000"

]

},

"next_openid":"NEXT_OPENID1"

}

https://api.yixin.im/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID1

{

"total":22010,

"count":10000,

"data":{

"openid":[

"OPENID1",

"OPENID2",

...,

"OPENID10000"

]

},

"next_openid":"NEXT_OPENID2"

}

https://api.yixin.im/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID2

{

"total":22010,

"count":2010,

"data":{

"openid":[

"OPENID1",

"OPENID2",

...,

"OPENID2010"

]

},

"next_openid":""

}

返回参数

参数描述

errcode接口返回码，0成功，其他都为失败

errmsg接口返回信息，若成功,返回返"请求成功",否则回具体失败原因

total关注该公众账号的总用户数

count拉取的OPENID个数，最大值为10000

data列表数据，OPENID的列表

next_openid拉取列表的后一个用户的OPENID

异常返回说明

{"errcode":40014,"errmsg":"不合法的access_token"}