接口描述
开发者通过该接口给当前需要签署的个人用户创建签署账号,并获取对应的个人签署账号id。
开发者在对接过程中,需注意:
电子签名SDK创建账户的接口只对证件号格式进行格式校验,不对个人信息的真实性进行校验,如果未单独对接e签宝的实名认证产品,则该签署人身份信息的真实性需要由贵司负责核实并保存核实结果。
接口名称
AccountService.addAccount(PersonBean person)
请求参数
展开全部参数参数名称 | 类型 | 必选 | 长度 | 参数说明 | 示例值 | |
person | PersonBean | 是 | 个人信息详情 | |||
name | String | 是 | 20 | 姓名 | ||
personArea | LegalAreaType | 是 | 个人身份证件类型,支持类型如下:
大陆身份证,15位或者17位+1位校验位
香港居民往来内地通行证,字母H或者h开头,后接8位或者10位数字
澳门居民往来内地通行证,字母M或者m开头,后接8位或者10位数字
台湾居民来往大陆通行证,8位或者10位数字
外籍,不校验
护照,GgEePpSsDd字母中任一开头+1位数字或【.】+7位数字,总计9位
军人身份证,15位或者17位+一位校验位
社会保障卡,15位或者17位+一位校验位
武装警察身份证件,不校验
户口簿,不校验
临时居民身份证,15位或者17位+一位校验位
外国人永久居留证,3位字母+12位数字
其他类型,不校验 | |||
idNo | String | 是 | 25 | 身份证号/护照号 | ||
mobile | String | 否 | 11 | 手机号码 | ||
String | 否 | 30 | 邮箱地址 | |||
organ | String | 否 | 30 | 所属公司 | ||
title | String | 否 | 20 | 职位 | ||
address | String | 否 | 150 | 常用地址 | ||
country | String | 否 | 20 | 国家 | ||
province | String | 否 | 20 | 省份 | ||
city | String | 否 | 20 | 城市 | ||
department | String | 否 | 20 | 部门 | ||
encrypt | Boolean | 否 | 用户信息是否加密传输,默认 false
|
响应参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | 示例值 | |
AddAccountResult | AddAccountResult | 是 | |||
errCode | int | 是 | 错误码,0标识成功,其他均标识失败 | 0 | |
msg | String | 否 | 错误信息,错误码对应的说明信息 | ||
errorShow | boolean | 否 | 错误信息是否建议显示 | ||
fingerprint | String | 否 | 指纹信息 | ||
accountId | String | 否 | 账号标识,创建后账号在e签宝平台中的唯一标识 |
请求示例
public static void main(String[] args) {
//获取正式生成服务
//获取客户端的代码:ServiceClient getKHD = ServiceClientManager.get("您的pojectId");
AccountService service = getKHD.accountService();
// 创建个人账号
AddAccountResult addAccountResult = service.addAccount(addPersonalAcct());
if (addAccountResult.getErrCode() != 0)
System.out.println("创建个人账号失败:" + addAccountResult.getMsg());
else
System.out.println("创建个人账号成功,e签宝平台对应的账号标识是:" + JSONObject.fromObject(addAccountResult));
}
/**
*
* description 个人账号信息
*/
private static PersonBean addPersonalAcct() {
PersonBean personBean = new PersonBean();
personBean.setEmail("test@tsign.cn");// 邮箱,可空
personBean.setMobile("182****9534");// 用于接收签署验证码的手机号码,可空
personBean.setName("芜浣");// 姓名,不可空
personBean.setIdNo("22030******40010");// 证件号码,不可空
personBean.setPersonArea(LegalAreaType.MAINLAND);// 个人身份证件类型,不可空
// 支持的证件类型如下:
// MAINLAND,大陆身份证,15位或者17位+一位校验位
// HONGKONG,香港居民往来内地通行证,字母H或者h开头,后接8位或者10位数字
// MACAO,澳门居民往来内地通行证,字母M或者m开头,后接8位或者10位数字
// TAIWAN,台湾居民来往大陆通行证,8位或者10位数字
// FOREIGN,外籍,不校验
// PASSPORT,护照,【GgEePpSsDd】中任一开头,后接1位0-9数字或者【.】,再+7位数字,总计9位
// SOLDIER_IDNO,军人身份证,15位或者17位+一位校验位
// SOCIAL_SECURITY_CARD,社会保障卡,15位或者17位+一位校验位
// ARMED_POLICE_ID,武装警察身份证件,不校验
// RESIDENCE_BOOKLET,户口簿,不校验
// TEMPORARY_IDNO,临时居民身份证,15位或者17位+一位校验位
// FOREIGNER_PERMANENT_RESIDENCE_PERMIT,外国人永久居留证,三位国籍代码(代码为字母,不区分大小写)+12位数字
// OTHER,其他,不校验
personBean.setOrgan("XX有限公司");// 所属公司,可空
personBean.setTitle("部门经理");// 职位,可空
personBean.setAddress("");// 常用地址,可空
personBean.setCountry("");// 国家,该参数可空
personBean.setProvince("");// 省份,该参数可空
personBean.setCity("");// 城市,该参数可空
personBean.setDepartment("");// 部门,可空
return personBean;
}
响应示例
{
"accountId":"4C8DC6A53F8C41B580A066E16E44D602",
"errCode":0,
"errShow":false,
"fingerprint":"",
"msg":"成功"
}
错误码
错误码 | 错误描述 | 解决方案 |
900105 | 该证书DN已存在,不能再重复申请 | cfca限制了重复dn的申请(证书名称+证件号码) |