QQ游戏开放平台

欢迎来到QQ游戏开放平台 登录| 管理中心 | 开发者论坛

/v3/user/gameapi_real_name_query

目录

功能说明

支持游戏的实名查询、判断并返回结果给到游戏,游戏方据此判断是否对用户执行防沉迷。

URL

https://[域名/IP]/v3/user/gameapi_real_name_query

正式环境下使用域名:openapi.minigame.qq.com

格式

JSON

HTTP请求方式

GET

IP限制

TRUE

输入参数说明

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

(1)公告参数

参数名称 类型 参数含义 可选/必选
openid
string
用户的唯一标识,根据APPID以及QQ号码生成
必选
openkey
string
用户的会话密钥
必选
appid unsigned int
应用的唯一ID,可以通过appid查找APP基本信息
必选
sig
string
请求串的签名,以appkey作为密钥
必选
(2)私有参数

 无

请求示例

https://openapi.minigame.qq.com/v3/user/gameapi_real_name_query?openid=14138F283ADE54B505EC9849254A25DA&openkey=A5ACECDBF7B8CD01EF7FA4C8FF809596&appid=100700930&sig=I8G6ncPeMBYIGBvjFOmD8BJyYqs%3D

返回参数说明

(1)公告返回码

参数名称
类型
含义
ret
int
返回码:0正确返回,其他情况为异常
msg
string
如果错误则返回错误信息,正确返回空
(2)私有返回码

参数名称
类型
含义
age
int
年龄
real_name_flag
int
实名标志:0 未实名 1 已实名
is_adult
int
是否成年:1 成年 0 未成年

注意:私有返回码只有在私有参数填写完整的情况下才会返回。

正确返回示例

JSON示例:


{

 

"ret":0,

 

"msg":"",

"age":18,

"real_name_flag":1,

"is_adult":1,

 

"seq":0,

 

"pf":""

错误返回示例

JSON示例:


{

   "ret":1000002,

   "msg":"您提交的参数不正确,请重新操作!",

   "uin":0

}

不同的异常,错误码不同。








联系我们 向上
回到顶部