认证

VibeVO 公共 API 使用 API 密钥。每个请求都必须在请求头中携带有效密钥。密钥标识所有者，其权限范围决定可以访问哪些接口。

密钥格式

vibevo_live_{prefix}.{secret}

• prefix — 简短的公开标识符，在后台可见。
• secret — 密钥的秘密部分，仅在创建时显示一次。

创建密钥

密钥在后台设置页面创建 — 底部有「API 密钥」区块。为其命名、选择权限范围、可选设置有效期，然后复制完整密钥（仅显示一次）。

发送密钥

支持两种等效的请求头，任选其一：

Authorization: Bearer vibevo_live_ab12cd.xxxxxxxxxxxxxxxx
X-API-Key: vibevo_live_ab12cd.xxxxxxxxxxxxxxxx

权限范围

只有两个粗粒度权限——不按资源单独选择：

• read — 任何 GET（广告活动、机会、数据分析、帖子、创作者、钱包、追踪链接、 工厂）。密钥始终拥有 read。
• write — 任何写入（内容工厂、提交视频）。

授权错误

• 401 Unauthorized — 密钥缺失、无效、过期或已吊销。
• 403 Forbidden — 密钥有效，但缺少该接口所需的权限范围。

更新日期: 2026 年 7 月 11 日