修改个人签署账号（通过accountId修改）

更新时间：2025-04-02 18:19:07

接口描述

此接口支持通过在【创建个人签署账号】接口返回的个人账号 accounId 更新账号信息

例如：

1. 更新账号的联系方式：手机号、邮箱

2. 若需更新姓名，已实名的账号会变为未实名状态，需要用户重新实名；

3. 若证件号码变更，此接口不支持变更证件号，建议开发者先调用【注销个人签署账号】接口，重新创建。

接口Url

/v1/accounts/{accountId}

请求方式Method

PUT

请求头Header

提供两种安全接入方式，开发者可选择其中一种方式进行对接，对应参数如何获取，参考文档【请点击】。

方式一：请求签名鉴权

请求头入参示例如下：

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

方式二：OAuth2.0鉴权

当安全接入选择OAuth2.0鉴权方式，请点击查阅详情，请求头入参示例如下：

参数名称	参数类型	必选	参数位置	参数说明
X-Tsign-Open-App-Id	string	是	Header参数	应用ID，通过开放平台创建获取
X-Tsign-Open-Token	string	是	Header参数	通过获取鉴权Token接口返回
Content-Type	string	是	Header参数	application/json; charset=UTF-8

请求参数

参数名称	参数类型	必选	参数位置	参数说明
accountId	string	是	Path参数	个人签署账号ID，通过创建个人签署账号API 获取
email	string	否	Body参数	邮箱地址，默认不变
mobile	string	否	Body参数	手机号码，默认不变
name	string	否	Body参数	姓名，默认不变
realnameEvidencePointId	string	否	Body参数	实名证据点ID（通过《创建个人实名证据点》接口获取）注：当不使用e签宝实名认证，需要将证据点上传到e签宝后，才能创建e签宝签署账号需确保证据点内的姓名和证件号和当前账号信息保持一致需联系e签宝技术人员开启后才可使用

公共响应参数

参数名称	参数类型	必选	参数说明
code	int	是	业务码，0表示成功
message	string	否	业务描述信息
data	object	否	业务数据

响应参数

参数名称	参数类型	必选	参数说明
accountId	string	是	个人账号id
name	string	否	姓名
idType	string	否	证件类型，默认CRED_PSN_CH_IDCARD （1）CRED_PSN_CH_IDCARD 大陆身份证，默认值（2）CRED_PSN_CH_TWCARD 台湾来往大陆通行证（台胞证）（3）CRED_PSN_CH_MACAO 澳门来往大陆通行证（回乡证）（4）CRED_PSN_CH_HONGKONG 香港来往大陆通行证（回乡证）（5）CRED_PSN_PASSPORT 护照
idNumber	string	否	证件号
mobile	string	否	手机号码
email	string	否	邮箱地址
thirdPartyUserId	string	否	第三方平台的用户id
status	Boolean	否	实名认证状态 true-已实名 false-未实名
realnameEvidencePointId	string	否	实名证据点ID

请求示例

PUT https://openapi.esign.cn/v1/accounts/账户accountID

{
    "email": "wu***y@tsign.com",
    "mobile": "182***xxxx",
    "name": "**"
}

响应示例

{
    "code":0,
    "message":"成功",
    "data":{
        "mobile":"182***xxxx",
        "email":"xxx@esign.cn",
        "cardNo":null,
        "name":"**",
        "accountId":"1eaf205d5d6d4e579a9d221d775xxxx",
        "idType":"CRED_PSN_CH_IDCARD",
        "idNumber":"3724******73829",
        "thirdPartyUserId":"20190923103830111",
        "thirdPartyUserType":"_DEFAULT_USER"
    }
}

错误码

错误描述

解决方案

401

1.token过期了

2.header请求头不正确

3.apiurl和应用ID环境不对应，例如apiurl是模拟环境，应用ID是正式环境的