工具 API

aitable__prepare_attachment_upload

为单个 attachment 字段文件申请带容量校验的 OSS 直传地址。 该工具仅适用于“需要先上传本地文件,再将其写入 attachment 字段”的场景,不是通用文件上传入口,也不适用于后续导入类任务上传。 如果已经有可直接下载的在线文件 URL,不要先下载文件再调用本工具;可直接在 create_records / update_records 的 attachment 字段中传入 [{"url":"https://..."}],由服务端自动代拉外链并转存为内部附件。 该工具只负责准备上传,不直接接收文件二进制内容;实际文件字节流应由客户端在 MCP 外上传到返回的 upl...

enterpriseOAuth1 积分

调用信息

工具标识
dingtalk.aitable__prepare_attachment_upload
服务提供方
钉钉
平均响应
0 ms
近 7 天调用
0

输入参数

baseId必填

Base ID,可通过 list_bases 或 search_bases 获取

fileName必填

待写入 attachment 字段的文件名,必须包含扩展名(如 report.xlsx、photo.png)。服务端会基于扩展名和 mimeType 推断资源类型。

mimeType

可选,文件 MIME type(如 application/pdf、image/png)。不传时服务端会根据 fileName 扩展名推断。若传入该值,则上传文件到 uploadUrl 时,PUT 请求必须携带 Content-Type header,且其值必须与这里完全一致。该字段只影响附件资源识别,不会把该工具升级为通用上传接口。

size必填

文件大小(字节),必须大于 0。prepare 阶段会用它向下游申请带容量校验的 attachment 上传地址。