注销个人签署账号(通过accountId注销)

更新时间:2021-01-26 16:55:34

接口描述

开发者通过创建个人签署账号API获取到个人签署账号accountId后,如需注销账号信息,可通过该接口注销;

需注意的是,注销后的账号accountId无法继续进行签署。


接口Url

/v1/accounts/{accountId}


请求方式Method

DELETE


请求头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获取

公共响应参数

参数名称

参数类型

必选

参数说明

codeint

业务码,0表示成功
messagestring

业务描述信息  

dataobject

业务数据

请求示例  

DELETE https://openapi.esign.cn/v1/accounts/{accountId}

响应示例

{
    "code": 0,
    "message": "成功",
    "data": null
}

错误码

错误码错误描述解决方案


我要纠错