v3/user/is_vip

目录

What's New?

2012年12月07日,本接口新增返回参数“is_yellow_high_vip”,用于判断用户是否为豪华版黄钻用户。
2012年8月30日,本接口新增返回参数“yellow_vip_pay_way”,用于判断用户的付费类型。

1 功能说明

验证登录用户是否黄钻,是否年费黄钻,如果是则返回其黄钻等级等信息。

注意,本接口与“获取用户信息”接口都返回了黄钻信息,但是二者之间有区别:
(1)本接口获取的黄钻信息是实时的,适用于需要黄钻信息特别准确的场景(例如每日礼包场景中,非黄钻用户开通黄钻后,返回应用应该立即可领取礼包);
(2)“获取用户信息”接口(v3/user/get_info)返回的否黄钻以及黄钻等级的信息是经过缓存的,有一定的延时,适用于不需要黄钻信息特别准确的场景(例如用户头像后的黄钻标识)。

2 接口调用说明

2.1 URL

http://[域名]/v3/user/is_vip

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

2.2 格式

json

2.3 HTTP请求方式

GET, POST

2.4 IP限制

TRUE

2.5 输入参数说明

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

(2)私有参数
无。

2.6 请求示例

http://113.108.20.23/v3/user/is_vip?
openid=B624064BA065E01CB73F835017FE96FA&
openkey=5F154D7D2751AEDC8527269006F290F70297B7E54667536C&
appid=2&
sig=9999b41ad0b688530bb1b21c5957391c&
pf=qzone&
format=json&
userip=112.90.139.30

2.7 返回参数说明

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

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

is_yellow_vip 是否为黄钻用户(0:不是; 1:是)
is_yellow_year_vip 是否为年费黄钻用户(0:不是; 1:是)
yellow_vip_level 黄钻等级。目前最高级别为黄钻8级(如果是黄钻用户才返回此字段)
is_yellow_high_vip 是否为豪华版黄钻用户(0:不是; 1:是)。

(当pf=qzone、pengyou或qplus时返回)

yellow_vip_pay_way 用户的付费类型。

0:非预付费用户(先开通业务后付费,一般指通过手机开通黄钻的用户);
1:预付费用户(先付费后开通业务,一般指通过Q币Q点、财付通或网银付费开通黄钻的用户)。

2.8 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
"ret": 0,
"is_lost": 0,
"is_yellow_vip": 1,
"is_yellow_year_vip": 1,
"yellow_vip_level": 7,
"is_yellow_high_vip": 0,
"yellow_vip_pay_way": 0
}

2.9 错误返回示例

Content-type: text/html; charset=utf-8
{
"ret":1002,
"msg":"请先登录"
}

3 示例代码

详见:SDK下载#OpenAPI V3.0 SDK下载

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

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部