个人账号创建
接口地址: /v1/accounts/createByThirdPartyUserId
请求方式: POST
接口描述:对接方调用本接口在e签宝平台中创建个人账号,后续有关该用户的所有操作都需使用该用户的accountId。如提供用户证件信息,则将根据提供的用户证件信息申请数字证书。
请求参数:
参数名称 | 说明 | 参数类型 | 是否必填 | 类型 |
---|---|---|---|---|
thirdPartyUserId | 用户唯一标识,可传入第三方平台的个人用户id、证件号、手机号、邮箱等,如果设置则作为账号唯一性字段,相同信息不可重复创建。(个人用户与机构的唯一标识不可重复) | body | true | string |
name | 姓名(非实名签署时必填) | body | false | string |
idType | 证件类型,详见个人证件类型说明 ,默认CRED_PSN_CH_IDCARD | body | false | string |
idNumber | 证件号(非实名签署时必填) | body | false | string |
mobile | 手机号码,默认空,手机号为空时无法使用短信意愿认证 | body | false | string |
邮箱地址,默认空 | body | false | string |
请求示例
POST https://openapi.esign.cn/v1/accounts/createByThirdPartyUserId
{
"email":"xx@qq.com",
"idNumber":"311111111111111111",
"idType":"CRED_PSN_CH_IDCARD",
"mobile":"15811111111",
"name":"测试用户",
"thirdPartyUserId":"A001"
}
响应参数
参数名称 | 说明 | 类型 |
---|---|---|
accountId | 个人账号id | string |
响应示例
{
"code":0,
"message":"成功",
"data":{
"accountId":"99b9513fa07c4dc4b1e77aecc2588cb6"
}
}
返回码说明
返回码 | 说明 |
---|---|
0 | 成功 |
53000000 | 账号已存在 |
53000001 | 账号不存在 |
53000002 | 账号类型不匹配 |