运营商二要素实名核验接口
更新时间:2024-10-19
1.功能说明
1.1.用于校验 [手机号+姓名] 或 [手机号+身份证号] 是否一致;
1.2.广泛用于实名注册、风控审核等场景。如电商、直播、游戏、金融等场景;
1.3.接口发送调用地址:http(s)://api.guoyangyun.com/api/verify/operator2.htm
1.4.请求方式:以HTTP POST请求的方式(推荐使用post方式);
1.5.汉字字符集:UTF-8,请注意参数的大小写。
1.2.广泛用于实名注册、风控审核等场景。如电商、直播、游戏、金融等场景;
1.3.接口发送调用地址:http(s)://api.guoyangyun.com/api/verify/operator2.htm
1.4.请求方式:以HTTP POST请求的方式(推荐使用post方式);
1.5.汉字字符集:UTF-8,请注意参数的大小写。
2.输入参数
参数 | 名称 | 类型 | 必须 | 描述 |
公共参数 | 公共参数 | — | 是 | 详见《公共参数和配置》文档 |
mobile | 手机号码 | String | 是 | 手机号码 |
name | 姓名 | String | 否 | 中文请使用 utf-8编码,防止乱码导致验证不通过 |
idCardNo | 身份证号码 | String | 否 | 身份证号码 |
支持两种组合验证方式,可根据需要传参:
1)[mobile+name]二要素核验
2)[mobile+idCardNo]二要素核验
2)[mobile+idCardNo]二要素核验
3.调用示例
http(s)://api.guoyangyun.com/api/verify/operator2.htm?appkey=xxxxxxx&appsecret=xxxxxxx&mobile=xxxxxxx&idCardNo=xxxxxxxx&name=xxxxxmobile
4.Json返回
4.1.返回参数
参数 | 名称 | 类型 | 描述 |
code | 返回码 | String | 提交返回结果。0:表示成功,其他:失败。(状态码详见:《公共错误代码定义》) |
msg | 信息描述 | String | 返回码对应的中文描述。 |
data | 核验结果 | List | 核验结果返回详情 |
responseCode | 校验结果 | String | 0:验证通过;其他:验证不通过 |
responseDesc | 结果描述 | String | 核验结果描述 |
traceNo | 流水号 | String | 商户流水号 |
4.2.调用成功样例
{
"code":"0",
"msg":"成功",
"data": {
"responseCode": "0", //0:验证通过;其他:验证不通过
"responseDesc": "验证通过", //核验结果描述
"traceNo": "3b71a1773a7" //商户流水号
}
}
4.3.调用失败样例
{
"code":"XXXX",
"msg":"错误提示内容"
}