流程附件添加

更新时间：2022-06-16 17:09:46

为流程添加附件, 附件必须先用文档管理接口创建，附件无需签署，只作为签署过程中的参考，比如录音、视频, 图片, 文档等。

注：因Windows操作系统中文件名称不支持个别特殊字符，现调整attachmentName字段不支持以下9个字符

/ \ : * " < > | ？以及所有emoji表情，详见文件名称特殊字符限制

/v1/signflows/{flowId}/attachments

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鉴权方式，请点击查阅详情，请求头入参示例如下：

参数名称	类型	必选	参数说明
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，该参数需放在请求地址里面，可以参考【请求示例】
attachments		array	是	body	附件列表数据
	attachmentName	string	是	body	附件名称，（必须带上文件扩展名，不然会导致后续发起流程校验过不去示例：合同.pdf ）；注意：（1）该字段的文件后缀名称和真实的文件后缀需要一致。比如上传的文件类型是word文件，那该参数需要传“xxx.docx”，不能是“xxx.pdf” （2）文件名称不支持以下9个字符： / \ : * " < > \| ？
	fileId	string	是	body	附件Id

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

{
    "attachments":[
        {
            "attachmentName":"第一份附件.pdf",
            "fileId":"97913b341a0142e08aef061c6ccae5da"
        }
    ]
}

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