个人账号修改

（1）按照账号ID修改

接口地址： /v1/accounts/{accountId}

请求方式： PUT

接口描述： 对接方调用本接口在e签宝平台中使用账号id更新个人账号，如变更姓名，则系统根据变更后的身份信息自动申请新数字证书。

请求参数

参数名称	说明	参数类型	是否必填	类型
accountId	账号id	path	true	string
email	联系方式，邮箱地址，默认不变	body	false	string
mobile	联系方式，手机号码，默认不变	body	false	string
name	姓名，默认不变	body	false	string
idType	证件类型，详见个人证件类型说明，默认为身份证	body	false	string
idNumber	证件号，该字段只有为空才允许修改	body	false	string

请求示例

PUT https://openapi.esign.cn/v1/accounts/99b9513fa07c4dc4b1e77aecc2588cb6

{
    "email": "yy@qq.com",
    "mobile": "15811111111",
    "name": "测试账号01",
    "idType":"CRED_PSN_CH_IDCARD",
    "idNumber":"311111111111111111"
}

响应参数

参数名称	说明	类型
accountId	个人账号id	string
name	姓名	string
idType	证件类型，详见个人证件类型说明，默认为身份证	string
idNumber	证件号	string
mobile	联系方式，手机号码	string
email	联系方式，邮箱地址	string
thirdPartyUserId	第三方平台的用户id	string

响应示例

{
    "code":0,
    "message":"成功",
    "data":{
        "mobile":"15811111111",
        "email":"yy@qq.com",
        "cardNo":null,
        "name":"测试账号01",
        "accountId":"99b9513fa07c4dc4b1e77aecc2588cb6",
        "idType":"CRED_PSN_CH_IDCARD",
        "idNumber":"311111111111111111",
        "thirdPartyUserId":"A001"
    }
}

返回码说明

返回码	说明
0	成功
53000000	账号已存在
53000001	账号不存在
53000002	账号类型不匹配
53000003	证件信息冲突

（2）按照第三方用户ID修改

接口地址： /v1/accounts/updateByThirdId

请求方式： POST

接口描述： 通过2.1.1接口创建的账号，当对接方创建账户时传入第三方平台的userId时，对接方调用本接口在e签宝平台中使用第三方用户id更新个人账号，如变更姓名，则系统根据变更后的身份信息自动申请新数字证书。

请求参数

参数名称	说明	参数类型	是否必填	类型
thirdPartyUserId	第三方平台的用户唯一标识	query	true	string
email	联系方式，邮箱地址	body	false	string
mobile	联系方式，手机号码	body	false	string
name	姓名	body	false	string
idType	证件类型，详见个人证件类型说明，默认为身份证	body	false	string
idNumber	证件号，该字段只有为空才允许修改	body	false	string

请求示例

POST https://openapi.esign.cn/v1/accounts/updateByThirdId?thirdPartyUserId=A001

{
    "email": "yy@qq.com",
    "mobile": "15811111111",
    "name": "测试账号01",
    "idType":"CRED_PSN_CH_IDCARD",
    "idNumber":"311111111111111111"
}

响应参数

参数名称	说明	类型
accountId	个人账号id	string
name	姓名	string
idType	证件类型,详见个人证件类型说明	string
idNumber	证件号	string
mobile	联系方式，手机号码	string
email	联系方式，邮箱地址	string
thirdPartyUserId	第三方平台的用户id	string

响应示例

{
    "code":0,
    "message":"成功",
    "data":{
        "mobile":"15811111111",
        "email":"yy@qq.com",
        "name":"测试账号01",
        "accountId":"99b9513fa07c4dc4b1e77aecc2588cb6",
        "idType":"CRED_PSN_CH_IDCARD",
        "idNumber":"311111111111111111",
        "thirdPartyUserId":"A001"
    }
}

返回码说明

返回码	说明
0	成功
53000000	账号已存在
53000001	账号不存在
53000002	账号类型不匹配
53000003	证件信息冲突

个人账号修改

个人账号修改

results matching ""

No results matching ""