/
API 密钥和 AI 连接可用的全部 15 个权限范围：每个权限范围允许做什么、在控制台中叫什么，以及哪些事任何 API 密钥都做不到。
权限范围决定 API 密钥可以做什么。同样的 15 个权限范围也适用于你通过 MCP 连接的 AI 助手。请始终只选择应用真正需要的权限范围。
基本规则
- 每个端点都恰好需要一个权限范围
- 对 API 密钥来说，write:X 自动包含 read:X，控制台中也会提示“write:X 自动包含 read:X”
- 缺少权限范围时，API 返回 403 insufficient_scope，并在 details.required_scope 中指出所需的权限范围
- 完全没有对 API 密钥开放的端点同样返回 403 insufficient_scope
- 成员、账单或管理域名等所有者和管理员功能，任何权限范围都无法访问
所有权限范围
在“创建新 API 密钥”对话框中，你为每个领域选择“读取”或“写入”；密钥列表显示第一列中的权限范围名称。“读取 · 页面”这种形式会出现在 AI 应用的授权页面上和“已连接的应用”中。
| 权限范围 | 在 AI 应用中 | 允许的操作 |
|---|---|---|
| read:pages | 读取 · 页面 | 列出和读取页面，读取和验证草稿，列出模块，读取 SEO，列出版本，获取模块类型 |
| write:pages | 写入 · 页面 | 创建和编辑页面（包括用户名），编辑草稿，创建、编辑、删除模块和调整其顺序，编辑 SEO、可见性，发布，恢复版本，私密页面的邀请链接 |
| read:links | 读取 · 链接 | 列出和读取页面的链接 |
| write:links | 写入 · 链接 | 创建、编辑、删除链接和调整其顺序 |
| read:assets | 读取 · 素材 | 列出素材 |
| write:assets | 写入 · 素材 | 上传和删除素材，为页面上传文件 |
| read:forms | 读取 · 表单 | 读取表单和摘要，列出提交记录并导出为 CSV（导出自 Creator Pro 起） |
| write:forms | 写入 · 表单 | 创建、编辑和删除表单 |
| read:stats | 读取 · 统计 | 页面和工作区统计（摘要、时间序列、对比、链接、小组件、转化、热门页面），推送历史和推送用量 |
| read:workspaces | 读取 · 工作区 | 读取套餐功能、用量、成员列表和工作区设置，列出域名，列出和读取模板，列出和读取回调密钥（不含明文密钥） |
| write:workspaces | 写入 · 工作区 | 目前没有超出 read:workspaces 的端点 |
| read:donations | 读取 · 支持者付款 | 工作区支持者付款的合计（通过“支持”模块收到的付款） |
| read:short_links | 读取 · 短链接 | 列出和读取短链接 |
| write:short_links | 写入 · 短链接 | 创建、编辑和删除短链接 |
| write:templates | 写入 · 工作区模板 | 创建、编辑和删除你自己的工作区模板（读取它们用 read:workspaces），参见自定义模板 |
哪些端点属于哪个权限范围，请参阅按领域分类的 API 端点。
任何 API 密钥都做不到的事
- 删除页面
- 为草稿创建预览链接
- 按设备、国家、来源网站和 UTM 细分的统计
- 发送推送通知和管理推送规则
- 连接或断开集成
- 管理 Webhook
- 添加、验证、启用、停用或删除域名
- 管理成员、邀请和角色，转让所有权
- 更改工作区设置，账单
- 创建、编辑、轮换或删除回调密钥
- 支持者付款列表、数据访问请求和匿名化表单提交记录
- 管理你的个人资料、你关注的页面以及 API 密钥本身
这些操作请在控制台中完成。
AI 助手的权限范围
对于 MCP 连接，你在授权页面上选择同样的权限范围。不过有两点不同：第一，在那里写入权限不包含读取权限，所以请两者都授予。第二，你的角色会限制可选的范围：查看者只能获得读取权限（不含表单和短链接），编辑者可以获得除“写入 · 工作区”、短链接和工作区模板之外的所有权限。更多信息请参阅 AI 助手：权限、安全和限制。
推荐组合
| 使用场景 | 权限范围 |
|---|---|
| 报表和仪表盘 | read:stats, read:pages |
| 从 CMS 或网店同步链接 | write:links, read:pages |
| 自动维护和发布页面 | write:pages, write:links |
| 从 CRM 生成活动链接 | write:short_links |
| 把表单中的潜在客户传给 CRM | read:forms |
| 从 CI 流水线发布模板 | write:templates, read:workspaces |
你可能还想了解
没找到答案？
告诉我们你需要什么，我们的客服团队会亲自帮你。