创建个人账号（SaaS API非标版签署产品通用）

接口描述

为个人用户创建账号，可用于个人实名认证。

【注】调用此接口的唯一标识是thirdPartyUserId，开发者需确保传入的 thirdPartyUserId 唯一，可以是用户的手机号、身份证号码等，创建成功后接口将返回唯一的accountId。

1. 用户的证件号码 idNumber 为非必传项，关于证件号接口规则请注意：

（1）传入该值，接口无真实性校验，开发者需要确保传入值真实可靠，创建成功后证件号无法修改，若需修改，请调用【注销个人账号】后使用正确的号码重新创建；

（2）不传入该值或者传空值，若需通过接口维护后期可调用【修改个人账号】接口补充证件号；

（3）原则上，开发者同一应用（AppId）下面一个证件号对应一个 thirdPartyUserId，接口限制最多允许一个证件号对应100个thirdPartyUserId，若超出限制，接口会返回报错信息：“该证件号创建用户数已达最大数量100个，不允许再继续创建”，需要开发者自行修改创建账号逻辑；

2. 创建成功后e签宝会根据个人证件信息申请数字证书，用于后续签署业务，以保障电子签名可靠性；

3. 若接口返回报错“code=53000000，message=账号已存在”：此报错表示已使用 thirdPartyUserId 创建过账号

接口

/v1/accounts/createByThirdPartyUserId

请求方式

POST

请求头

提供两种安全接入方式，对应参数如何获取，参考文档【请点击】。

方式一：请求签名鉴权（优先推荐）

参数名称	类型	必选	参数说明
X-Tsign-Open-App-Id	string	是	应用ID
Content-Type	string	是	application/json;charset=UTF-8
X-Tsign-Open-Ca-Timestamp	string	是	API 调用者传递时间戳，值为当前时间的毫秒数，也就是从1970年1月1日起至今的时间转换为毫秒，时间戳有效时间为15分钟，为了防重放攻击
Accept	string	是	建议统一填写 /
X-Tsign-Open-Ca-Signature	string	是	签名字符串
Content-MD5	string	否	当请求 Body 非 Form 表单时，可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时，加上此请求头。
X-Tsign-Open-Auth-Mode	string	是	选择请求方式进行鉴权，固定值，Signature

方式二：OAuth2.0鉴权（不推荐使用）

当安全接入选择OAuth2.0鉴权方式，请点击查阅详情。

请求参数

参数名称	类型	必选	参数位置	参数说明
thirdPartyUserId	string	是	body	用户唯一标识，由开发者自定义【注】建议传入第三方平台的个人用户id、证件号、手机号、邮箱等，可作为账号唯一性字段，相同信息不可重复创建。（个人用户与机构的唯一标识不可重复）
name	string	是	body	姓名
idType	string	否	body	证件类型 CRED_PSN_CH_IDCARD - 中国大陆身份证（默认值） CRED_PSN_CH_TWCARD - 台湾来往大陆通行证 CRED_PSN_CH_MACAO - 澳门来往大陆通行证 CRED_PSN_CH_HONGKONG - 香港来往大陆通行证 CRED_PSN_PASSPORT - 护照【注】如果调用“认证服务纯API版”接口时，该字段必传
idNumber	string	否	body	证件号，默认为空，发起签署前需确保补齐证件号。补充说明：如果调用“认证服务纯API版”接口时，该字段必传；身份证中有X字母的，需要传入大写的X。
mobile	string	否	body	手机号码，默认空，手机号为空时无法使用短信意愿认证
email	string	否	body	邮箱地址，默认空

响应参数

展开全部参数参数名称（点击左侧“+”一键展开）		类型	必选	参数说明
code		int32	是	业务码，0表示成功，非0表示异常。
message		string	是	错误信息请根据 code 来判断错误情况，不应该依赖message匹配，因为 message 可能会调整。
data		object	否	业务信息
	accountId	string	否	个人账号ID（可用于个人实名认证）

请求示例

{
    "thirdPartyUserId":"2019082630111",
    "name":"**",
    "idType":"CRED_PSN_CH_IDCARD",
    "idNumber":"371204xxxxxxxx4930",
    "mobile":"182681xxxxx",
    "email":"xxx@tsign.com"
}

Postman请求示例

响应示例

{
    "code":0,
    "message":"成功",
    "data":{
        "accountId":"1eaf205d5d6d4e579a9d221d775xxx"
    }
}