鉴权
所有 /v1 端点(除 /v1/account/credits 外)都需要 API Key。
获取 Key
登录后在 开发者控制台 创建。Key 形如 one1_live_xxxxxxxx(正式)或 one1_test_xxxxxxxx(测试)。明文只在创建时显示一次,请妥善保存;泄露可随时在控制台吊销并重建。
传递方式(二选一)
- Bearer(推荐)
- X-API-Key
curl "https://one1.cn/v1/text-search?q=NIKE&nice=25" \
-H "Authorization: Bearer one1_live_xxxxxxxx"
curl "https://one1.cn/v1/text-search?q=NIKE&nice=25" \
-H "X-API-Key: one1_live_xxxxxxxx"
Key 数量
每个账户可同时持有的有效 Key 数按档位:免费版 3 把 · 入门版 5 把 · 成长版 10 把 · 企业版 20 把(MCP 授权自动签发的 Key 不计入)。同一账户的所有 Key 共用该账户的 API 点与每账户限速,多开 Key 不会叠加点数或速率。
鉴权与权限失败
| 状态码 | code | 含义 |
|---|---|---|
| 401 | invalid_key | 缺少或无效的 API Key |
| 403 | key_owner_missing | Key 有效,但绑定邮箱尚未开通 One1 账号,无法计费 |
| 403 | paid_plan_required | 免费版调用第三方数据源接口(合规检测系列、伙伴国辖区、Listing 改写),未扣点;购买任一 API 套餐即可使用 |
| 403 | forbidden_entitlement | Key 所属套餐无权使用该能力(如 EPO 检索),请升级 |
所有错误响应顶层都带 request_id(= 响应头 X-Request-Id)与 error.retryable,详见错误处理。