个人账号创建

接口地址: /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
email 邮箱地址,默认空 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 账号类型不匹配

results matching ""

    No results matching ""