开发者 · 公开只读 API

面向第三方数据复用的只读 JSON 接口(Team 档权益)。 只返回结论层——与公开页面同源;绝不返回 base_url 原文、API Key 或任何检测入参。

鉴权与限流

  • Header:Authorization: Bearer lai_…(Token 在工作台创建;只显示一次)
  • 限流:按 Token 每分钟请求数 = 订阅计划值(Team 60 rpm;超限 429)
  • 每个响应带 x-request-id——对账/排障时凭它串联全链路日志

GET /api/public/board

榜单结论层。参数:limit(1–100,默认 20)、offset、protocol(openai / anthropic / gemini)。

{
  "version": "rank-v2.1",
  "generatedAt": "2026-10-04T12:00:00.000Z",
  "rows": [{
    "domainNorm": "api.example.com",
    "rank": 1,
    "protocols": ["openai"],
    "medianScore": 87.4,
    "rankKey": 71.2,
    "confidenceLowerBound": 82.9,
    "criticalRateUpper": 0.04,
    "sampleCount": 24,
    "insufficientEvidence": false,
    "lastFinishedAt": "2026-10-03T09:12:00.000Z"
  }]
}

GET /api/public/site/{domain}

站点聚合 + 近 20 条公开检测(模型/档位/分数/判定/官方标记)。无公开数据时返回 404——证据不足 ≠ 有问题。

缓存与稳定性

  • 响应可被共享缓存(s-maxage=60 + stale-while-revalidate=300):payload 与 Token 无关,对所有调用方同值
  • 字段只增不改;废弃字段会保留至少一个季度并在此页公告
  • 三个分数语言的语义见 术语表(medianScore ≠ rankKey ≠ 通过率,不可互换)

红线提醒:本 API 输出与公开页面完全同源——订阅/付费不改变任何分数、判定与排序(架构断言测试在 CI 强制执行)。