开发者 · 公开只读 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 强制执行)。