v3/user/is_area_login

目录

What's New?

即将发布:
本接口后台服务器计划在2012年11月28日升级,升级后接口参数seqid只能传string型,不再兼容int型值,请开发者务必确认接口调用是否符合要求,否则将会影响所有玩家无法登录服务器。
wiki中本接口参数seqid规定为string型,目前发现部分开发者没有遵守规范,对seqid进行了int型校验。
本次升级将原来的string型自增seqid修改为32位无序字符串类型,因此原有对seqid进行了int型校验的应用将在本次升级后出现seqid无法通过校验的情况。
请原有调用本接口时对seqid进行了int型校验的应用在2012年11月28日前做如下代码改造:
不要对seqid做int型校验,并扩展为使用32位string类型进行存储,在调用is_area_login接口时,seqid按原样返回即可。

1 功能说明

本接口仅适用于多区多服应用,用来验证用户登录态(即验证openkey),以及验证用户是否从选区页面(即验证seqid)进入应用。
多区多服应用中设置有验证用户是否从选区页面进入应用的逻辑,将有助于防止用户直接通过修改应用地址的方式进入应用。
需要注意的是:
(1)调用本接口后,可以做openkey以及seqid的验证,如果需要对openkey进行续期则需要调用v3/user/is_login
(2)用户每次从选区页面登录后生成的seqid具有有效期,只可使用一次,验证一次后就会过期。即如果应用使用同样的seqid和参数发送2次请求,第一次返回成功,第二次则会报错。


下面详细描述了验证是否从选取页面进入应用的详细过程:
(1)用户登录后进入应用,在选区页面点击某一大区;
(2)腾讯登录服务器验证用户登录态;验证成功后,登记其登录信息,生成seqid;然后将页面跳转到应用,跳转URL中带有用户的openid,openkey,seqid。
(3)第三方应用调用本API,传入跳转URL中带的openid,openkey,seqid等参数,腾讯后台服务器验证openkey和seqid。
如下图所示,请开发者关注下图中“第三方应用”下对应的动作:
check_login_1.png

2 接口调用说明

2.1 URL

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

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

2.2 格式

json

2.3 HTTP请求方式

GET, POST

2.4 IP限制

TRUE

2.5 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738

(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数

参数名称 是否必须 类型 描述
seqid 必须 string 标识单次多区多服登录的特征码,通过该seqid可找到用户登录的唯一记录。由平台直接传给应用,应用原样传给平台即可。

用户点击某一大区服务器登录后,服务器端会验证用户登录态,登记登录请求信息,并产生seqid,然后跳转到应用服务器,在跳转URL中带有seqid以及openid,openkey参数,见接口说明中流程图。

即将发布:本接口后台服务器即将升级,该升级可能造成所有玩家无法登录游戏的严重运营事故,请开发者务必确认接口调用中是否存在以下问题。
本接口参数seqid规定传string型,部分开发者没有遵守规范,传递的是int型。在此之前,接口对int型值是兼容的,本次升级后不再兼容int型值,这将导致不遵守规范的应用出现所有玩家无法登录游戏的严重运营事故。请开发者尽快进行代码改造,避免应用出现故障。

2.6 请求示例

http://openapi.tencentyun.com/v3/user/is_area_login?
openid=0000000000000000000000001FF3F656&
openkey=6F5D3470D2140158D66663CC42D6AE67&
appid=24599&
sig=****************&
pf=qzone&
format=json&
userip=112.90.139.30&
seqid=186136582

2.7 返回参数说明

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

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

2.8 正确返回示例

JSON示例:

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

:该接口暂时不支持返回xml的数据格式。

2.9 错误返回示例

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

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

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部