下载审批附件

**
接口调用量说明**钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，获取审批文件下载授权，并且生成下载链接。

接口调用说明

说明

如果审批单是手动在钉钉客户端发起的，手动选择本地文件作为附件，调用本接口获取的附件下载地址的格式为#zifgs49xxxxx.file。需要与获取单个审批实例详情接口结合使用，获取实例详情接口得到附件的fileName和fileType，按照本接口返回的#zifgs49xxxxx.file进行名称和后缀替换，该附件才可正常打开。

附件文件大小不能为0，否则不支持获取下载链接。

该接口只能下载审批附件钉盘空间的文件，无法下载到审批评论的附件。

调用本接口，可以下载审批附件钉盘空间的文件，如下图所示。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	工作流实例写权限	API Explorer
第三方企业应用	暂不支持	暂不支持	暂不支持
第三方个人应用	暂不支持	暂不支持	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	invalidParameter	下载审批附件参数错误	下载审批附件参数错误
400	userNotExist	用户不存在	用户不存在
400	invalidProcessInstanceId	实例id不能为空	实例id不能为空
400	hsfIntegrationErrorCspaceGetCustomSpace	获取钉盘space的信息失败	获取钉盘space的信息失败
400	hsfIntegrationErrorCspaceGetSimpleMicroAppByRelatedAppId	根据relatedAppId查询获取微应用信息失败	根据relatedAppId查询获取微应用信息失败
400	hsfIntegrationErrorCspaceDentryServiceGrant	授权访问钉盘失败	授权访问钉盘失败
400	hsfIntegrationErrorCspace	钉盘附件依赖三方错误	钉盘附件依赖三方错误
400	invalidFileId	审批附件fileId不能为空	审批附件fileId不能为空
400	processInstNotExist	审批实例不存在	审批实例不存在
400	noPermission	无访问权限	无访问权限
400	processNotExist	审批流不存在	审批流不存在
400	processGetFailedByParameter	无操作审批流的权限，请检查审批实例或者模版是否正确	无操作审批流的权限，请检查审批实例或者模版是否正确
400	hsfIntegrationErrorCspaceDentryServiceGenerateDownloadPresignedUrl	产生文件下载的链接失败	产生文件下载的链接失败
400	internalError	%s	系统内部异常
500	systemError	系统异常	系统异常

curl --location --request POST 'https://api.dingtalk.com/v1.0/workflow/processInstances/spaces/files/urls/download' \ --header 'x-acs-dingtalk-access-token;' \ --header 'Content-Type: application/json' \ --data-raw '{ "processInstanceId" : "a17444d1-075b-4a4d-xxxx", "fileId" : "111" }'

请求参数

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。

企业内部应用，调用获取企业内部应用的accessToken接口获取。

Body 参数application/json

processInstanceId

string

必需

审批实例ID。调用发起审批实例接口获取InstanceId参数值。调用获取审批实例ID列表接口获取list参数值。

fileId

string

必需

文件fileId，调用获取单个审批实例详情接口获取fileId参数值。说明文件id是审批组件中上传的fileId（如下图所示），评论中上传的附件fileId暂不支持获取下载链接。

示例

返回响应

🟢200成功

application/json

Body

result

object

返回结果。

必需

spaceId

integer

钉盘空间ID。

必需

fileId

string

文件ID。

必需

downloadUri

string

必需

文件下载地址。说明文件下载地址有效期15分钟。

success

boolean

必需

接口调用是否成功。 true：成功 false：失败

接口调用说明#

权限#

错误码#

请求参数

返回响应

接口调用说明

权限

错误码