使用Storyblok CMS API时遭遇401“未授权”错误

1. 确认Token类型与环境匹配 #

• Storyblok分预览Token和公开Token，免费社区版默认需使用预览Token（空间设置→API密钥中标记为Preview Token的字段）。若误用公开Token但内容未发布，会直接返回401。
• 每个空间的Token独立，务必复制当前操作空间的对应Token，不要混淆其他空间的密钥。

2. 排查Token输入错误 #

• 手动输入Token易出现多空格、字符遗漏问题，建议直接从Storyblok后台复制后粘贴到curl命令或代码中，避免手动录入失误。
• 执行curl命令前，确认URL中的Token未被转义或截断，可直接在终端打印完整URL验证。

3. 调整请求参数与端点 #

• 你的curl命令端点正确，但GET请求无需Content-Type头（无请求体），可简化命令后重试：

  curl "https://api.storyblok.com/v2/cdn/stories?token=你的实际Token" -X GET -H "Accept: application/json"
  

4. 检查空间访问限制 #

• 进入Storyblok后台空间设置，确认API访问控制未开启IP白名单，若开启需将当前设备IP加入允许列表（免费版默认关闭该限制，但仍需确认）。
• 检查空间状态是否正常，长期未使用的免费版空间可能被冻结，后台会有对应提示。

5. 内容发布状态验证（针对公开Token） #

• 若尝试使用公开Token访问，需确保目标Story已发布到生产环境。未发布的内容仅能通过预览Token访问，可在内容编辑器右上角点击「发布」按钮推送内容。

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