功能说明
完成用户的实名认证
URL
http://[域名/IP]/v3/user/gameapi_real_name_register
正式环境下使用域名: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作为密钥 |
必选 |
charset |
string |
url中汉字的编码方式,utf-8或者gbk,不填默认为utf-8 |
可选 |
(2)私有参数
参数名称 |
类型 |
参数含义 |
可选/必选 |
idnumber |
string |
身份证号 |
必选 |
name |
name |
用户姓名,编码方式由charset决定 |
必选 |
请求示例
http://openapi.minigame.qq.com/v3/user/gameapi_real_name_register?openid=6B58FDBC4708E80A69D51F43981590D8&openkey=222F5A0AF61D084CA909D7082555A919&appid=100700930&charset=utf-8&idnumber=533122197805182975&name=%E6%B5%8B%E8%AF%95&sig=N14Y%2BGmu%2F94SbehP%2FLXTtZSxs88%3D
返回参数说明
(1)公告返回码
参数名称 |
类型 |
含义 |
ret |
int |
返回码:0正确返回,其他情况为异常 |
msg |
string |
如果错误则返回错误信息,正确返回空 |
参数名称 |
类型 |
含义 |
reg_result |
int |
注册结果: 0:请求成功 1:系统错误 2:没有权限 3:访问频限 4:该用户没有实名认证 5:用户已注册 6:证件绑定超过限制 7:用户没有注册(修改时可能返回) 8:证件没有绑定openid 100:非法参数输入 101:非法的身份证 102:非法的生日 103:非法的中文名字 104:token过期或openid不合法 |
注意:私有返回码只有在私有参数填写完整的情况下才会返回。
正确返回示例
JSON示例:
{
"ret":0,
"msg":"",
"uin":0,
"reg_result":0,
"seq":0,
"pf":""
}
错误返回示例
JSON示例:
{
"ret":1000002,
"msg":"您提交的参数不正确,请重新操作!",
"uin":0
}
不同的异常,错误码不同。