移动证书登入账号预绑定接口文档
概述
本文档内容为证书签名平台为提供的接口描述。描述范围有整体规范,安全性描述,每个接口的输入与输出描述,测试地址等信息。调用接口必须满足《sdk_接口规范》列出的规范要求。
定义
- 预绑定:用于没有证书情况下,确认其账户与移动证书之间的预关联关系。绑定关系建立后,登录不需要再使用绑定接口。
移动证书绑定与移动证书登录之间的关系
在使用证书登录之前,是需要先建立证书也业务系统之间的绑定关系的。在绑定关系建立后,以后可以使用证书直接登录。
接口清单
接口 | 类型 | 描述 |
---|---|---|
generatePreBind | server | 预绑定请求接口,需要审核身份证照片 |
apiCaPreBind
预绑定请求接口
接口名 | caPreBind/generatePreBind |
---|---|
接口描述 | 移动证书预绑定请求接口(generatePreBind) |
输入参数(data)
参数名称 | 类型 | 必填 | 说明 |
---|---|---|---|
phone | String | 是 | 预绑定手机号,需用此手机号对真宜签产品注册激活预绑定,最大11位 |
account | String | 是 | 外部系统账号,最大100个可见字符 |
userName | String | 是 | 用户姓名,最大100个可见字符 |
idCardNo | String | 是 | 身份证号,最大11个可见字符 |
idCardFront | String | 是 | 身份正面图,base64数据传输 |
idCardBack | String | 是 | 身份反面图,base64数据传输 |
返回参数
参数名称 | 类型 | 必填 | 说明 |
---|---|---|---|
bindId | String | 是 | 绑定ID |
JAVA调用实例
实例所需依赖请查看javaSdk
String url="xxx";//接口请求地址
String phone = "";//预绑定手机号
String account = "";//外部系统账号
String userName = "";//用户姓名
String idCardNo = "";//身份证号
String idCardFront = "";//身份正面图
String idCardBack = "";//身份反面图
String methodUrl = "caPreBind/generatePreBind";
String appId="";//应用id,由云签平台分配
String appSecret="";//云签分配的密钥,只作数据签名使用
Map<String, Object> params = new HashMap<String, Object>();
params.put("phone", phone);
params.put("account", account);
params.put("userName", userName);
params.put("idCardNo", idCardNo);
params.put("idCardFront", idCardFront);
params.put("idCardBack", idCardBack);
String data = JSONObject.toJSONString(params);
Map channelContext = MessageUtil.getChannelContext(appId, appSecret,
"app_secret", data, null);
String rpcResult = HttpsClientUtil.getInstance().httpsPost(
url+"/api/v1/"+methodUrl,
JSONObject.toJSONString(channelContext)
);
System.out.println("返回结果:" + rpcResult);