创建个人签署账号

更新时间:2024-10-15 05:57:10

接口描述

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

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

接口地址

http://ip:port/paas-sdk-service/timevale/account/addPerson

请求方式

POST

请求数据格式

application/json; charset=UTF-8

请求参数

参数名称

类型

必选

参数说明

name

string

姓名

idNo

string

证件号码

idNoType

string

个人身份证件类型,默认大陆身份证,支持类型如下:

  • MAINLAND - 大陆身份证(15位或者17位+1位校验位)
  • HONGKONG - 香港居民往来内地通行证(字母H或者h开头,后接8位或者10位数字)
  • MACAO - 澳门居民往来内地通行证(字母M或者m开头,后接8位或者10位数字)
  • TAIWAN - 台湾居民来往大陆通行证(8位或者10位数字)
  • PASSPORT - 护照(e签宝校验规则:1-25位的大小写字母或者数字组合)
  • OTHER - 其他类型(不校验证件格式)

encrypt

boolean

用户信息是否加密传输,默认 false

  • true - 加密
  • 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
}



我要纠错