流程附件列表

更新时间：2021-08-05 16:33:43

接口描述

查询流程关联的所有附件。

接口

/v1/signflows/{flowId}/attachments

请求方式

GET

请求头

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

方式一：请求签名鉴权（优先推荐）

请求头入参示例如下：

参数名称	类型	必选	参数说明	示例值
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

请求参数

参数名称	类型	必选	参数类型	参数说明	示例值
flowId	string	是	path	流程id

公共响应参数

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

响应参数

展开全部参数参数名称		类型	必选	参数说明	示例值
attachments		array	否	附件列表数据
	attachmentName	string	否	附件名称
	attachmentUrl	string	否	附件地址, 有效时间1小时；该链接建议只用于下载，不要直接预览
	fileId	string	否	附件Id
	createTime	int	否	创建时间

请求示例

GET https://openapi.esign.cn/v1/signflows/429b1d3038854cabbcdac0a63d7e4c0d/attachments

响应示例

{
    "code":0,
    "message":"成功",
    "data":{
        "attachments":[
            {
                "fileId":"97913b341a0142e08aef061c6ccae5da",
                "attachmentName":"第一份附件.pdf",
                "attachmentUrl":"https://esignoss.oss-cn-hangzhou.aliyuncs.com/1111563786/1e4adc02-d339-43e6-aa02-8a77a9a4a48d/%E7%AC%AC%E4%BA%8C%E4%BB%BD?Expires=1560775239&OSSAccessKeyId=LTAIdvHfiVrzDKbE&Signature=qRN5eiVpV7jeoHQyue/vSPPKRGg%3D",
                "createTime":1560771456787
            }
        ]
    }
}

错误码

错误描述

解决方案

401

1.token过期了

2.header请求头不正确

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