接口描述
使用此接口可以将文档直接整理到e签宝官网的企业合同已归档合同目录下的具体分类里。
使用场景：当企业文件较多，需要在e签宝官网下新建很多类目去分别管理，正常流程签署完成后不会自动分类到官网具体的目录下，会默认在待归档合同里。手动分类整理比较耗费时间，可以通过此接口直接整理文档到e签宝官网具体的已归档目录分类下。
【注】
为了便于开发者理解，2023年1月11日该接口由“智能台账-归档分类”更名为“e签宝官网企业合同-归档分类”，接口内容无变化。
如图方式来复制所属目录的分类ID传入接口入参menuId中：
接口地址
/v2/open/grouping_files/grouping
请求方式
POST
请求头
提供两种安全接入方式，开发者可选择其中一种方式进行对接，对应参数如何获取，参考文档【请点击】。
方式一：请求签名鉴权（优先推荐）
请求头入参示例如下：
参数名称 | 类型 | 必选 | 参数说明 |
X-Tsign-Open-App-Id | string | 是 | 项目ID |
Content-Type | string | 是 | application/json;charset=UTF-8 |
X-Tsign-Open-Ca-Timestamp | string | 是 | API 调用者传递时间戳，值为当前时间的毫秒数，也就是从1970年1月1日起至今的时间转换为毫秒，时间戳有效时间为15分钟，为了防重放攻击 |
Accept | string | 是 | 建议统一填写 */* |
X-Tsign-Open-Ca-Signature | string | 是 | 签名字符串 |
Content-MD5 | string | 否 | 当请求 Body 非 Form 表单时，可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时，加上此请求头。 |
X-Tsign-Open-Auth-Mode | string | 是 | 选择请求方式进行鉴权，固定值，Signature |
方式二：OAuth2.0鉴权（不推荐使用）
当安全接入选择OAuth2.0鉴权方式，请点击查阅详情，请求头入参示例如下：
参数名称 | 类型 | 必选 | 参数说明 |
X-Tsign-Open-App-Id | string | 是 | 项目ID |
X-Tsign-Open-Token | string | 是 | 通过获取鉴权Token接口返回 |
Content-Type | string | 是 | application/json; charset=UTF-8 |
请求参数
参数名称 | 类型 | 必选 | 参数类型 | 参数说明 |
menuId | string | 是 | body | 合同归属的分类ID 注意：从e签宝官网已归档合同分类里复制 |
flowIdList | array | 是 | body | 流程列表 注意： 接口创建签署时返回的流程id（flowId）集合， 最多支持一次传入100个流程id（flowId）。 |
公共响应参数
参数名称 | 类型 | 必选 | 参数说明 |
code | int | 是 | 业务码，0表示成功 |
message | string | 否 | 信息 |
data | object | 否 | 业务信息 |
请求示例
POST https://openapi.esign.cn/v2/open/grouping_files/grouping
{
"menuId": "45632d6ff80123453dd000559ea148",
"flowIdList": [
"123bb23***58e0be6",
"001edb***20da6057"
]
}响应示例
{
"code": 0,
"message": "成功",
"data": true
}
我要纠错