创建个人签署账户

更新时间:2024-01-23 17:35:46

接口描述

开发者通过该接口给当前需要签署的个人用户创建签署账号,并获取对应的个人签署账号id。

开发者在对接过程中,需注意:

电子签名SDK创建账户的接口只对证件号格式进行格式校验,不对个人信息的真实性进行校验,如果未单独对接e签宝的实名认证产品,则该签署人身份信息的真实性需要由贵司负责核实并保存核实结果。

接口名称

AccountService.addAccount(PersonBean person)

请求参数

展开全部参数参数名称

类型

必选

长度

参数说明

示例值

person

PersonBean


个人信息详情


name

String

20

姓名


personArea

LegalAreaType


个人身份证件类型,支持类型如下:

  • MAINLAND

大陆身份证,15位或者17位+1位校验位

  • HONGKONG

香港居民往来内地通行证,字母H或者h开头,后接8位或者10位数字

  • MACAO

澳门居民往来内地通行证,字母M或者m开头,后接8位或者10位数字

  • TAIWAN

台湾居民来往大陆通行证,8位或者10位数字

  • FOREIGN

外籍,不校验

  • PASSPORT

护照,GgEePpSsDd字母中任一开头+1位数字或【.】+7位数字,总计9位

  • SOLDIER_IDNO

军人身份证,15位或者17位+一位校验位

  • SOCIAL_SECURITY_CARD

社会保障卡,15位或者17位+一位校验位

  • ARMED_POLICE_ID

武装警察身份证件,不校验

  • RESIDENCE_BOOKLET

户口簿,不校验

  • TEMPORARY_IDNO

临时居民身份证,15位或者17位+一位校验位

  • FOREIGNER_PERMANENT_RESIDENCE_PERMIT

外国人永久居留证,3位字母+12位数字

  • OTHER

其他类型,不校验


idNo

String

25

身份证号/护照号


mobile

String

11

手机号码


email

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

  • true - 加密
  • 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的申请(证书名称+证件号码)



我要纠错