check_page_fans
特别声明:
本接口不需要申请接口访问权限。
本接口不需要申请接口访问权限。
1 接口说明
验证登录的用户是否为某个认证空间的粉丝。
1.1 URL
OAuth2.0协议: https://graph.qq.com/user/check_page_fans
1.2 格式
json,xml
1.3 HTTP请求方式
GET
1.4 输入参数说明
各个参数请进行URL 编码,编码时请遵守 RFC 1738
(1)通用参数
-OAuth2.0协议必须传入的通用参数,详见这里。
(2)私有参数
| 参数名称 | 是否必须 | 类型 | 描述 |
|---|---|---|---|
| page_id | 必须 | string | 表示认证空间的QQ号码。 |
| format | string | 定义API返回的数据格式。 取值说明:为xml时表示返回的格式是xml;为json时表示返回的格式是json。 注意:json、xml为小写,否则将不识别。format不传或非xml,则返回json格式数据。 |
1.5 请求示例
以OAuth2.0协议为例(敏感信息都用*号进行了处理,实际请求中需要替换成真实的值):
https://graph.qq.com/user/check_page_fans?
access_token=*************&
oauth_consumer_key=123456&
openid=****************&
format=json&
page_id=654321
access_token=*************&
oauth_consumer_key=123456&
openid=****************&
format=json&
page_id=654321
1.6 返回参数说明
| 参数名称 | 描述 |
|---|---|
| ret | 返回码,正常为0 |
| msg | 如果ret不为0,会有相应的错误信息提示,返回数据全部用UTF-8编码 |
| isfans | 1 表示登录的用户是该认证空间的粉丝; 0 表示登录的用户没有关注该认证空间。 |
1.7 返回码说明
0: 正确返回。
其它: 失败。
OpenAPI公共错误码说明详见:公共返回码说明。
1.8 正确返回示例
{
"ret":0,
"msg":"",
"isfans":"1",
}1.9 错误返回示例
Content-type: text/html; charset=utf-8
{
"ret":100029,
"msg":"错误的http请求"
}