接口描述
创建个人用于电子签名的账户。
电子签名SDK创建账户的接口只对证件号格式进行格式校验,不对个人信息的真实性进行校验,如果未单独对接e签宝的实名认证产品,则该签署人身份信息的真实性需要由贵司负责核实并保存核实结果。
接口
http://ip:port/tech-sdkwrapper/timevale/account/addPerson
请求方式
POST
请求参数
参数名称 | 类型 | 必选 | 参数说明 | 示例值 |
name | string | 是 | 姓名 | |
idNo | string | 是 | 身份证号/护照号 | |
string | 否 | 邮箱地址 | ||
mobile | string | 否 | 手机号码 | |
organ | string | 否 | 所属公司 | |
title | string | 否 | 职位 | |
address | string | 否 | 常用地址 | |
personArea | int | 否 | 证件类型,默认为19-大陆身份证,枚举类型如下: 13-护照, 14-军人身份证 15-社会保障卡 16-武装警察身份证件 17-港澳居民往来内地通行证 18-台湾居民来往大陆通行证 19-大陆身份证 20-户口簿 21-临时居民身份证 22-外国人永久居留证 23-其他 | |
encrypt | Boolean | 否 | 用户信息是否加密传输,默认 false
|
响应参数
参数名称 | 类型 | 必选 | 参数说明 | 示例值 |
errCode | int | 是 | 错误码 | |
msg | string | 否 | 错误信息 | |
errShow | boolean | 否 | 错误信息是否显示 | |
accountId | string | 否 | 账户标识 | |
fingerprint | string | 否 | 当指定创建指纹证书时返回的指纹信息 |
请求示例
请求参数示例:具体根据实际业务场景进行传参,此处仅为参考
请求数据采用json格式、UTF-8编码,请求数据类型Content-Type=application/json
POST http://localhost:8080/tech-sdkwrapper/timevale/account/addPerson
localhost:8080这里参考https://qianxiaoxia.yuque.com/docs/share/7c96dfbc-1e53-4de3-b1f6-46e10eda67b4
{
"name": "芜浣",
"idNo": "37xxxxxxxxxxxxxxx",
"mobile": "182xxxxxxxx34",
"title":"职位"
}
响应示例
{
"msg": "成功",
"accountId": "58FEB50DCBAC41BF80503DF5DCC74DA6",
"errCode": 0,
"errShow": false
}
错误码
错误码 | 错误描述 | 解决方案 |
150020 | 证件号与证件类型不匹配 | |
1068 | 手机号格式不正确 | |
1011 | 身份证号或护照号必填 |