创建个人账号

更新时间:2021/08/05 18:58:54

接口描述

对接方调用本接口在e签宝平台中创建个人账号,后续有关该用户的所有操作都需使用该用户的accountId。如提供用户证件信息,则将根据提供的用户证件信息申请数字证书。

接口

/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_IDCARD 中国大陆身份证

CRED_PSN_CH_TWCARD 台湾来往大陆通行证

CRED_PSN_CH_MACAO 澳门来往大陆通行证

CRED_PSN_CH_HONGKONG 香港来往大陆通行证

CRED_PSN_PASSPORT 护照

注:如果调用“认证服务纯API版”接口时,该字段必传


idNumber

string

body

证件号,默认为空,发起签署前需确保补齐证件号。

注:1、如果调用“认证服务纯API版”接口时,该字段必传

2、身份证中有X字母的,需要传入大写的X


mobile

string

body

手机号码,默认空,手机号为空时无法使用短信意愿认证


email

string

body

邮箱地址,默认空


公共响应参数

参数名称

类型

必选

参数说明

示例值

code

int

业务码,0表示成功


message

string

信息


data

object

业务信息


响应参数

参数名称

类型

必选

参数说明

示例值

accountId

string

个人账号id


请求示例  

{
    "thirdPartyUserId":"2019082630111",
    "name":"芜浣",
    "idType":"CRED_PSN_CH_IDCARD",
    "idNumber":"371204199604234930",
    "mobile":"182681xxxxx",
    "email":"wuhuan@tsign.com"
}

Postman请求示例

响应示例

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

错误码

错误码

错误描述

解决方案