v3/page/is_fans

目录

1 功能说明

验证登录用户是否为某个认证空间的粉丝。
应用可以调用本接口判断用户是否您应用的认证空间粉丝,对于非粉丝用户可以邀请关注您的认证空间,从而对您的应用进行更好的推广。

注:
认证空间分为普通版认证空间和APP版认证空间。
普通版认证空间开通方式详见:http://page.opensns.qq.com/
APP版认证空间申请方式详见:APP版认证空间说明

2 接口调用说明

2.1 URL

http://[域名]/v3/page/is_fans

正式环境域名或测试环境IP详见:API3.0文档#请求URL说明

2.2 格式

json

2.3 HTTP请求方式

GET, POST

2.4 IP限制

TRUE

2.5 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738
(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数

参数名称 是否必须 类型 描述
page_id 必须 string 表示认证空间的QQ号码。

2.6 请求示例

示例仅做格式参考,数据不具有参考性,实际请求中需要替换成真实的值。

http://113.108.20.23/v3/page/is_fans?
openid=B624064BA065E01CB73F835017FE96FA&
openkey=5F154D7D2751AEDC8527269006F290F70297B7E54667536C&
appid=2&
sig=*********************&
pf=qzone&
format=json&
userip=112.90.139.30&
page_id=12345678

2.7 返回参数说明

参数名称 描述
ret 返回码。详见公共返回码说明#OpenAPI V3.0 返回码
msg 如果错误,返回错误信息。
is_lost 判断是否有数据丢失。如果应用不使用cache,不需要关心此参数。

0或者不返回:没有数据丢失,可以缓存。
1:有部分数据丢失或错误,不要缓存。

is_fans 登录用户是否为认证空间的粉丝(0:不是; 1:是)。

如果传入的“page_id”不是一个认证空间的QQ号码,则ret返回一个错误码,并且is_fan返回0。

2.8 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
"ret": 0,
"is_lost": 0,
"is_fans": 1
}

2.9 错误返回示例

Content-type: text/html; charset=utf-8
{
"ret":1,
"msg":"请求参数错误",
"is_fans":0
}

以上信息是否解决您的问题?

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部