接口描述
开发者通过该接口给当前需要签署的个人用户创建签署账号，并获取对应的个人签署账号ID。
开发者在对接过程中，需注意：
- 开发者需要把《数字证书服务协议》展示到自身页面内，用户浏览勾选同意后才可以帮助用户生成e签宝签署账号（点击查看 《数字证书服务协议》模板），详见《电子签名使用合规性处理说明》。
- 该接口只对证件号格式进行格式校验，不对个人信息的真实性进行校验，建议开发者提前接入个人二要素信息比对接口确认信息准确后再创建个人签署账号，详见 《个人2要素信息比对》。
接口名称
AccountService.addAccount(PersonParam person)
请求参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | |
person（点击“+”展开详情） | PersonParam | 是 | 个人信息详情 | |
name | String | 是 | 姓名 | |
idNoType | IdNoTypeEnum | 是 | 个人身份证件类型，支持类型如下：
| |
idNo | String | 是 | 证件号码 | |
encrypt | boolean | 否 | 用户信息是否加密传输，默认 false
| |
响应参数
展开全部参数参数名称 | 类型 | 必选 | 参数说明 | |
addAccountResult（点击“+”展开详情） | AddAccountResult | 是 | 响应结果类 | |
errCode | int | 是 | 错误码，0标识成功，其他均标识失败 | |
msg | String | 否 | 错误信息，错误码对应的说明信息 | |
errorShow | boolean | 否 | 错误信息是否建议显示 | |
accountId | String | 否 | 签署账号ID，后续通过该账号进行签署 （在当前应用ID下唯一） | |
请求示例
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));
}
/**
* 创建个人签署账号
*/
private static PersonParam addPersonalAcct() {
PersonParam person = new PersonParam();
person.setName("张三");// 姓名，不可空
person.setIdNo("22030******40010");// 证件号码，不可空
person.setIdNoType(IdNoTypeEnum.MAINLAND);// 个人身份证件类型，不可空
// 支持的证件类型如下：
// MAINLAND，大陆身份证，15位或者17位+一位校验位
// HONGKONG，香港居民往来内地通行证，字母H或者h开头，后接8位或者10位数字
// MACAO，澳门居民往来内地通行证，字母M或者m开头，后接8位或者10位数字
// TAIWAN，台湾居民来往大陆通行证，8位或者10位数字
// PASSPORT，护照，【GgEePpSsDd】中任一开头，后接1位0-9数字或者【.】，再+7位数字，总计9位
// OTHER，其他，不校验
return person;
}响应示例
{
"msg": "成功",
"accountId": "CCCDF8CCF5C24B11BC370AB9742E2D5A",
"errCode": 0,
"errShow": false
}
我要纠错