功能说明
支持游戏的实名查询、判断并返回结果给到游戏,游戏方据此判断是否对用户执行防沉迷。
URL
https://[域名/IP]/v3/user/gameapi_real_name_query
正式环境下使用域名:openapi.minigame.qq.com
格式
JSON
HTTP请求方式
GET
IP限制
TRUE
输入参数说明
各个参数请进行URL 编码,编码时请遵守 RFC 1738
(1)公告参数
(2)私有参数
参数名称
类型
参数含义
可选/必选
openid
string
用户的唯一标识,根据APPID以及QQ号码生成
必选
openkey
string
用户的会话密钥
必选
appid
unsigned int
应用的唯一ID,可以通过appid查找APP基本信息
必选
sig
string
请求串的签名,以appkey作为密钥
必选
无
请求示例
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 |
如果错误则返回错误信息,正确返回空 |
参数名称 |
类型 |
含义 |
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
}
不同的异常,错误码不同。