接口描述
开发者通过该接口给当前需要签署的个人用户创建签署账号,并获取对应的个人签署账号ID。
开发者在对接过程中,需注意:
- 开发者需要把《数字证书服务协议》展示到自身页面内,用户浏览勾选同意后才可以帮助用户生成e签宝签署账号(点击查看 《数字证书服务协议》模板),详见《电子签名使用合规性处理说明》。
- 该接口只对证件号格式进行格式校验,不对个人信息的真实性进行校验,建议开发者提前接入个人二要素信息比对接口确认信息准确后再创建个人签署账号,详见 《个人2要素信息比对》。
接口地址
http://ip:port/paas-sdk-service/timevale/account/addPerson
请求方式
POST
请求数据格式
application/json; charset=UTF-8
请求参数
参数名称 | 类型 | 必选 | 参数说明 |
name | string | 是 | 姓名 |
idNo | string | 是 | 证件号码 |
idNoType | string | 否 | 个人身份证件类型,默认大陆身份证,支持类型如下:
|
encrypt | boolean | 否 | 用户信息是否加密传输,默认 false
|
响应参数
参数名称 | 类型 | 必选 | 参数说明 |
errCode | int | 是 | 错误码,0标识成功,其他均标识失败 |
msg | string | 否 | 错误信息,错误码对应的说明信息 |
errorShow | boolean | 否 | 错误信息是否建议显示 |
accountId | string | 否 | 签署账号ID,后续通过该账号进行签署 (在当前应用ID下唯一) |
请求示例
{
"name": "张三",
"idNo": "3711xxxxxxxxx1234",
"idNoType":"MAINLAND",
"encrypt":false
}
响应示例
{
"msg": "成功",
"accountId": "58FEB50DCBAC41BF80503DF5DCC74DA6",
"errCode": 0,
"errShow": false
}