微端实名接口文档

1. 玩家实名状态接口

1.1 接口

http://microgame.5054399.net/user/realname/status

1.2 调用方式

GET

1.3 使用场景

获取玩家实名状态,根据状态提交实名信息进行认证

1.4 输入

    GET:
        userId => 3082030983 /// 用户ID

1.5 输出

/// 成功
{
    "code": 30000,
    "message": "success",
    "data":
    {
        "cert": 1,      /// 1已认证 0未认证;根据此字段,判断是否要弹出实名面板
        "reconfirm": 1, /// 1确认 0不确认;二次确认标识,如未成年人是否弹修改确认框
        "status": 1,    /// 状态码,根据此字段,游戏实现防沉迷逻辑
                        /// -2:未填写实名信息
                        /// -1:有填写,但是内容不合规(例如早期的15位身份证号,随便填写等)
                        ///  0:未成年
                        ///  1:成年人
        "desc": "成年人" /// 状态描述,
    }
}

/// 失败
{
    "code": 30001,
    "message": "fail",
    "data":
    {
        "cert": 0,      /// 1已认证 0未认证;根据此字段,判断是否要弹出实名面板
        "reconfirm": 0, /// 1可修改 0不可修改;二次确认标识,如未成年人修改确认框
        "status": 404,
        "desc": "您尚未登录,请先登录"
    }
}

2. 提交实名信息接口

1.1 接口

http://microgame.5054399.net/user/realname/submit

1.2 调用方式

POST

1.3 使用场景

提交实名信息进行认证

1.4 输入

 POST:
        userId => 3082030983,           /// 用户ID
        realname => '实名',              /// 身份证对应真实姓名
        idcard => '320307194312242257', /// 身份证号
        appId => 'abd', /// 登录appid
        userName => 'haha', /// 用户名
        time => 1111, /// 时间戳,
        token => 'jsjsjsj'  /// token

1.5 输出

/// 成功
{
    "code":30000,
    "message":"success",
    "data":{
            "status":100,
            "desc":"实名信息保存成功", /// 失败时,尽量按desc提示,后续会调整文案,适配相关部门检查
            "reconfirm": 0          /// 1可修改 0不可修改;二次确认标识,如未成年人修改确认框
    }
}
/// 失败
{
    "code":30001,
    "message":"fail",
    "data":{
            "status":603,
            "desc":"身份证号不允许修改", /// 失败时,尽量按desc提示,后续会调整文案,适配相关部门检查
            "reconfirm": 0            /// 1可修改 0不可修改;二次确认标识,如未成年人修改确认框
    }
}

{
    "code" => 30011,
    "message" => "token_error"
}
{
    "code" => 30012,
    "message" => "params_error"
}