鉴权
所有 /v1 端点(除 /v1/account/credits 外)都需要 API Key。
获取 Key
登录后在 开发者控制台 创建。Key 形如 one1_live_xxxxxxxx(正式)或 one1_test_xxxxxxxx(测试)。明文只在创建时显示一次,请妥善保存;泄露可随时在控制台吊销并重建。
传递方式(二选一)
- Bearer(推荐)
- X-API-Key
curl "https://radarsea.com/v1/text-search?q=NIKE&nice=25" \
-H "Authorization: Bearer one1_live_xxxxxxxx"
curl "https://radarsea.com/v1/text-search?q=NIKE&nice=25" \
-H "X-API-Key: one1_live_xxxxxxxx"
鉴权失败
| 状态码 | code | 含义 |
|---|---|---|
| 401 | invalid_key | 缺少或无效的 API Key |
| 403 | forbidden_entitlement | 当前档位无权使用该能力(需升级) |
详见错误处理。