一、指令概述
该指令用于调用钉钉开放平台接口,获取钉盘内任意文件的在线打开链接,支持文档、表格、图片、PDF 等全格式文件,链接可直接在浏览器打开、用于钉钉消息推送、表单附件、报表嵌入,是钉盘文件分享与预览的核心指令。
可查看官方文档: https://open.dingtalk.com/document/development/obtains-the-object-preview-or-editing-information
二、核心参数配置
| 参数名称 | 说明 | 输入格式 / 规则 |
| 凭证 | 钉钉开放平台接口调用凭证(access_token) | 必填;通过「获取开发平台凭证」指令获取 |
| 用户 Id | 操作人钉钉用户 ID | 必填;通过「查询用户 Id」指令获取 |
| space_id | 钉盘空间 ID | 必填;通过「获取空间列表」指令获取 |
| 文件 Id | 钉盘内目标文件唯一 ID | 必填;由「上传文件到钉钉文件存储」指令执行后返回 |
| 生成变量【文件链接】 | 输出结果变量 | 必填;返回可直接访问的文件在线查看 URL |
三、典型操作示例
· 凭证:ding_access_token_xxxx
· 用户 Id:m4PgPMMZNiijuStvkgQD2VAiEiE
· space_id:28821344555
· 文件 Id:220623333333
· 输出变量:file_view_url
· 执行效果:返回文件在线打开链接,直接浏览器访问即可查看完整文件内容。
四、注意事项
1. 权限校验:操作人必须拥有该文件的查看权限;