审批钉盘空间&附件MCP复制页面下载审批附件POST/v1.0/workflow/processInstances/spaces/files/urls/download调试Run in ApifoxRun in Apifox**接口调用量说明**钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。调用本接口，获取审批文件下载授权，并且生成下载链接。接口调用说明#说明如果审批单是手动在钉钉客户端发起的，手动选择本地文件作为附件，调用本接口获取的附件下载地址的格式为#zifgs49xxxxx.file。需要与获取单个审批实例详情接口结合使用，获取实例详情接口得到附件的fileName和fileType，按照本接口返回的#zifgs49xxxxx.file进行名称和后缀替换，该附件才可正常打开。附件文件大小不能为0，否则不支持获取下载链接。该接口只能下载审批附件钉盘空间的文件，无法下载到审批评论的附件。调用本接口，可以下载审批附件钉盘空间的文件，如下图所示。权限#要调用此API，需要以下权限之一。应用类型是否支持权限API Explorer调试企业内部应用支持工作流实例写权限API Explorer第三方企业应用暂不支持暂不支持暂不支持第三方个人应用暂不支持暂不支持暂不支持错误码#HttpCode错误码错误信息说明400invalidParameter下载审批附件参数错误下载审批附件参数错误400userNotExist用户不存在用户不存在400invalidProcessInstanceId实例id不能为空实例id不能为空400hsfIntegrationErrorCspaceGetCustomSpace获取钉盘space的信息失败获取钉盘space的信息失败400hsfIntegrationErrorCspaceGetSimpleMicroAppByRelatedAppId根据relatedAppId查询获取微应用信息失败根据relatedAppId查询获取微应用信息失败400hsfIntegrationErrorCspaceDentryServiceGrant授权访问钉盘失败授权访问钉盘失败400hsfIntegrationErrorCspace钉盘附件依赖三方错误钉盘附件依赖三方错误400invalidFileId审批附件fileId不能为空审批附件fileId不能为空400processInstNotExist审批实例不存在审批实例不存在400noPermission无访问权限无访问权限400processNotExist审批流不存在审批流不存在400processGetFailedByParameter无操作审批流的权限，请检查审批实例或者模版是否正确无操作审批流的权限，请检查审批实例或者模版是否正确400hsfIntegrationErrorCspaceDentryServiceGenerateDownloadPresignedUrl产生文件下载的链接失败产生文件下载的链接失败400internalError%s系统内部异常500systemError系统异常系统异常请求示例请求示例ShellJavaScriptJavaSwiftcURLcURL-WindowsHttpiewgetPowerShellcurl --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"
}'响应示例响应示例{
"result": {
"spaceId": 0,
"fileId": "string",
"downloadUri": "string"
},
"success": true
}请求参数Header 参数生成代码x-acs-dingtalk-access-tokenstring 必需调用该接口的访问凭证。企业内部应用，调用获取企业内部应用的accessToken接口获取。Body 参数application/json生成代码processInstanceIdstring 必需审批实例ID。 调用发起审批实例接口获取InstanceId参数值。 调用获取审批实例ID列表接口获取list参数值。fileIdstring 必需文件fileId，调用获取单个审批实例详情接口获取fileId参数值。 说明 文件id是审批组件中上传的fileId（如下图所示），评论中上传的附件fileId暂不支持获取下载链接。示例返回响应🟢200成功application/json生成代码Body生成代码resultobject 返回结果。必需spaceIdinteger 钉盘空间ID。必需fileIdstring 文件ID。必需downloadUristring 必需文件下载地址。 说明 文件下载地址有效期15分钟。successboolean 必需接口调用是否成功。 true：成功 false：失败【钉钉】API开发者 微信交流群
用微信扫右侧二维码，加入【钉钉】API开发者 交流群，互助沟通
扫码加入交流群修改于 2024-01-11 09:52:49上一页授权下载审批钉盘文下一页同意或拒绝审批任务LLMs.txt克隆导出Built with