接口参考

所有接口都在 https://api.vibevo.io 上的 /api/v1/public/ 前缀之下，并需要带有相应权限范围的 API 密钥。

密钥身份

• GET /me — 当前密钥的身份（所有者、权限范围）。

活动

• GET /campaigns — 活动列表。范围 read，游标分页。
• GET /campaigns/{id} — 单个活动。范围 read。
• GET /campaigns/{id}/posts — 活动帖子。范围 read，游标 + 可选状态筛选。
• GET /campaigns/{id}/creators — 按账号聚合、按观看量排序的创作者。范围 read。
• GET /campaigns/{id}/tracking-links — 追踪链接，含 uniqueClicks。范围 read。

机会（面向创作者）

• GET /offers — 创作者的机会墙（可参与的 RUNNING 广告活动），含面向创作者的 条款（报酬/CPM、要求、takenAt），不含广告主的预算/花费。范围 read。
• GET /posts — 你在所有活动中提交的帖子：状态、观看量、收入、活动、账号与提交 日期，另含 summary（总数、审核中、累计收入）。范围 read。游标 + 可选 status / platform 过滤。

数据分析

• GET /analytics/campaigns/{id} — 活动数据分析。范围 read。

钱包

• GET /wallet — 当前余额。范围 read。
• GET /wallet/transactions — 账单记录。范围 read，游标分页。

游标分页

列表接口使用游标分页。传入 limit（1 到 100）和 cursor：

GET /api/v1/public/campaigns?limit=50&cursor=1234

{
  "data": [ /* ... */ ],
  "nextCursor": "5678"
}

金额格式

金额以 { raw, currency, decimals } 结构返回，其中 raw 是以字符串表示的最小单位整数；真实值 = raw / 10^decimals。活动预算和帖子收入为美分（decimals: 2，USD）；钱包余额和账单交易为 USDT 最小单位（decimals: 6）。

错误格式

{
  "statusCode": 403,
  "code": "insufficient_scope",
  "message": "Missing required scope: read",
  "timestamp": "2026-07-11T12:00:00.000Z",
  "path": "/api/v1/public/campaigns"
}

请以字符串字段 code 进行程序化处理。

curl 示例

curl https://api.vibevo.io/api/v1/public/campaigns?limit=20 \
  -H "Authorization: Bearer vibevo_live_ab12cd.xxxxxxxxxxxxxxxx"

curl https://api.vibevo.io/api/v1/public/wallet \
  -H "X-API-Key: vibevo_live_ab12cd.xxxxxxxxxxxxxxxx"

更新日期: 2026 年 7 月 11 日