使用「Retrieve block children」端点获取Button块时类型显示unsupported问题咨询

可能原因 #

• API版本不兼容：Notion API对button类型块的支持是从2022-06-28版本开始正式引入的。如果你的请求使用了更早的Notion-Version头，API会将Button块识别为unsupported。
• 非原生Button块：如果该块是通过第三方工具、插件创建的自定义块，或是Notion内部的实验性未开放块，API无法将其识别为标准的button类型，只会标记为unsupported。
• 列表接口返回简化信息：Retrieve block children接口默认返回的块信息可能是简化版，部分类型字段可能未被正确填充。

解决办法 #

• 升级API版本：在请求头中设置Notion-Version为2022-06-28或更新的版本（如最新的2024-02-28）。示例请求头：

  Notion-Version: 2024-02-28
  

• 验证块的原生性：在Notion客户端中确认该块是官方原生的Button块（而非第三方自定义块）。如果是自定义块，API无法识别为标准button类型，只能以unsupported返回。
• 单独获取块详情：针对该Button块的ID，调用Retrieve a block端点单独获取详情，该接口会返回更完整的块信息，可能会正确显示type: "button"。
• 检查权限配置：确保你的Notion集成拥有该页面的read权限，排除因权限不足导致的类型识别异常。

内容的提问来源于stack exchange，提问作者Sai Chirag