用户实名认证链接
服务说明
[!NOTE]
获取企业或个人saas注册认证链接,支持PC端和移动端,返回的链接地址暂不支持小程序。
http请求方式
[!NOTE]
POST multipart/form-data
http请求地址
[!NOTE]
$SERVICE_URL/v2/sign/saas/advancedAuth/link #其中$SERVICE_URL为生产或测试的地址
http请求参数
[!NOTE]
除公共必填参数外,还需要传以下参数
参数 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
mobileOrEmail | string | * | 邮箱或手机号;手机号属于个人注册,邮箱属于企业注册。 | |
name | string | ? | 用户名称 | |
identityCard | string | ? | 证件号 个人传身份证号,企业传营业执照号/统一社会信用代码号 | |
legalName | string | ? | 法人名称 企业时需传 | |
backUrl | string | ? | 认证后或授权后跳转链接(需携带协议头如https或http 否则转跳会失败) | |
authType | int | * | 认证类型,0.全部验证方式;1:短信邀请、人脸,2:银行卡四要素,3:个人注册、注册且授权:运营商认证 | |
linkType | int | ? | 0 | 链接类型,0:仅注册,1:注册授权,2:仅授权 |
organizationRegImg | file | ? | 企业营业执照图片 | |
identityFrontImg | file | ? | 身份证人像面 | |
identityBackImg | file | ? | 身份证国徽面 |
代码实现
JAVA实现
Map<String, Object> params = bodyParams;
String url = SERVICE_URL + "/v2/sign/saas/advancedAuth/link";
params.put("mobileOrEmail", "ee1@bccto.me"); //机号或邮箱,手机号属于个人注册,邮箱属于企业注册
params.put("name", "0"); //用户名称
params.put("identityCard", "0"); //证件号(企业传统一社会信用代码,个人传身份证号)
params.put("legalName", "0"); // 法人姓名
params.put("backUrl", "https://xxxxxx"); //认证后或授权后跳转链接
params.put("authType", "0"); //认证类型,0.全部验证方式;1:短信邀请、人脸,2:银行卡四要素,3:个人注册、注册且授权:运营商认证
params.put("linkType", "0"); //链接类型,0:仅注册,1:注册授权,2:仅授权
// params.put("organizationRegImg", new File("d:\\唐\\timg.jpg")); //组织注册证件扫描件,营业执照或事业单位法人证书
/* params.put("identityFrontImg", new File("d:\\唐\\委托签字.pdf")); // 身份证正面文件
params.put("identityBackImg", new File("d:\\唐\\委托签字.pdf")); //身份证反面*/
String str = HttpClientUtils.init().getPost(url, null, params, true);
http返回参数
[!NOTE]
返回response为application/json的数据,其字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
success | bool | * | 成功true;异常false |
msg | string | ? | 异常时,返回异常原因 |
resultCode | string | * | 异常时返回 |
data | string | ? | 注册认证链接(支持h5和pc,有效期7天) |
[!NOTE]
返回结果,参考:
//正确响应:
{"data":{"saasLink":"https://account-sandbox.ebaoquan.org/login/authentication?ap=%2Fauth%2FauthGuide%3FmultiSignatoryKey%3DA236E547DDB84FACAE8BB6B4846C5B62&cp=https%3A%2F%2Fweb.sandbox.junziqian.com%2Flogin%2Fauthorize&t=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJndWVzc3MgV2hvIEFtIEk_IjoiTVRFNU1UVTQiLCJpQW1Mb2dpblRpbWUxMjMiOiJNek0zTnprMiIsImV4cCI6MTY5MTgzMTczN30.x4sB8Bh-Hi3mhjTd9pZvqACZIBAS8ZIaBSGx3Boen9w&s=48361a61dc932eaf9022600834f65291"},"success":true}
//错误响应:
{"msg":"邮箱或手机信息不能为空","resultCode":"HTTP_PARAM_ERROR","success":false}