You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Notion API 2021-08-16版本不再返回File Object的url属性问题求助

Notion API 返回文件对象缺失 url 字段解决方案

问题原因

你使用的2021-08-16版本Notion API近期推送了文件资源权限校验规则更新,url字段缺失是因为当前调用接口的集成未开通对应资源的内容读取权限,接口鉴权不通过时会自动隐藏url、expiry_time两个敏感字段。

修复步骤

  • 进入Notion集成管理后台,找到你调用API使用的对应集成,在权限配置栏勾选「读取内容」权限后保存变更。
  • 打开你拉取内容的目标页面/父数据库,点击右上角「分享」按钮,确认该集成已被添加到协作列表,协作权限至少设置为「可查看」。
  • 若完成上述两步后问题仍存在,可在请求头的Notion-Version字段传入更高兼容版本(推荐2022-06-28),该版本对文件字段返回逻辑做了专项优化,适配性更强。

补充说明

Notion内部存储的文件返回的url默认带时效性,有效期为1小时,拿到返回结果后请及时处理,不要长期存储该链接直接使用。


内容的提问来源于stack exchange,提问作者Axel Paris

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.30 23:24:02