사용자 목록 가져오기


사용자 목록 가져오기

1474939796871028.png

공개 계정은 이 인터페이스를 통해 계정의 팔로어 목록을 가져올 수 있습니다. 팔로어 목록은 OpenID 문자열로 구성됩니다(암호화된 WeChat ID, 각 사용자는 공식 계정의 OpenID는 고유합니다.) 단일 풀 호출로 최대 10,000명의 팔로어 OpenID를 가져올 수 있으며, 필요에 따라 여러 번 가져올 수 있습니다.

인터페이스 호출 요청 설명

http 요청 방법: GET(https 프로토콜을 사용하세요)

https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID

# 🎜 🎜#access_tokenis통화 인터페이스 자격 증명next_openid첫 번째 OPENID를 가져오고, 채워지지 않으면 기본적으로 처음부터 가져옵니다.

반환 지침

올바른 경우 JSON 데이터 패킷을 반환합니다.

{"total":2,"count":2,"data":{"openid":["","OPENID1","OPENID2"]}, "next_openid":"NEXT_OPENID"}
Parameter필수인가요설명
#🎜 🎜#is # 🎜🎜#
ParameterDescription
total공개 계정을 팔로우하는 총 사용자 수
count가져온 OPENID 수, 최대값은 10000
데이터 목록 data , OPENID
next_openid목록에서 마지막 사용자의 OPENID를 가져옵니다


오류 발생 시 JSON 데이터 패킷 반환(예: 잘못된 AppID 오류):

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

첨부: 팔로워 수가 10,000명을 초과하는 경우

공개 계정의 팔로워 수가 10,000명을 초과하는 경우 next_openid 값을 입력하고 목록을 여러 번 가져와 필요에 맞게 가져올 수 있습니다.

구체적으로는 인터페이스 호출 시 이전 호출에서 반환된 next_openid 값이 다음 호출에서도 next_openid 값으로 사용됩니다.

예는 다음과 같습니다.

공개 계정 A에는 23,000명의 팔로워가 있습니다. 팔로우 인터페이스를 통해 모든 팔로워를 얻으려면 다음과 같이 URL을 요청하세요: https://api.weixin.qq.com/cgi-bin/user/get?access_token = ACCESS_TOKEN 반환 결과:
{
"total":23000,
"count":10000,
"data":{"
openid":[
"OPENID1",
"OPENID2",
...,
" OPENID10000 "
]
},
"next_openid":"OPENID10000"
}https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID1 반환 결과:
{
"전체 " :23000,
"count":10000,
"data":{
"openid":[
"OPENID10001",
"OPENID10002",
...,
"OPENID20000"
]
},
"next_openid " :"OPENID20000"
}https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID2 반환 결과(팔로워 목록이 반환된 경우 반환된 next_openid는 비어 있음):
{
"총계":23000,
"개수":3000,
"데이터":{"
"openid":[
"OPENID20001",
"OPENID20002",
...,
"OPENID23000"
]
},
"next_openid":"OPENID23000"
}