基础信息
Base URL https://agentapiai.com
Auth none
Format JSON（UTF-8）
Cache Cache-Control: public, max-age=60
CORS Access-Control-Allow-Origin: *
Version X-API-Version: 1.0
OpenAPI 描述：/v1/openapi.json。所有响应都带 ok；失败时带 error 与 HTTP 状态码。
端点
| METHOD | PATH | 说明 |
|---|---|---|
| GET | /v1/sites | 站点列表；支持 limit（≤200）、offset、grade、q、sort |
| GET | /v1/sites/{slug} | 单个站点公开档案；不存在返回 404 |
| GET | /v1/stats | 站点数、样本总数、等级分布、数据版本 |
| GET | /v1/reports | 已发布检测报告列表（没有就是空数组） |
| GET | /v1/detect/latest?host= | 该 host 已发布报告中的最近结论；没有公开报告返回 404 |
示例
curl -sS 'https://agentapiai.com/v1/sites?grade=a&limit=5'
curl -sS 'https://agentapiai.com/v1/sites/totokenscc'
curl -sS 'https://agentapiai.com/v1/stats'
curl -sS 'https://agentapiai.com/v1/detect/latest?host=api.example.com'
列表响应的 meta 带 total、limit、offset、datasetVersion、generatedAt 与 window。引用数据时请带 datasetVersion，否则无法对应到具体快照。
边界
- 只读：没有下单、充值、改配置、删数据接口。
- 不含 API Key、完整探测 URL、用户身份或支付信息。
- 检测结论只覆盖“已发布报告”；没有报告不等于通过。
- 公开等级只描述 7 天窗口内的可用性样本，不是模型真伪或资金安全结论。
- 请勿高频轮询；静态数据 60 秒缓存，批量拉取请用
limit/offset分页。
客户端
CLI（alpha，源码在仓库 cli/）：
node cli/bin/agentapiai.mjs sites --grade a --limit 10
node cli/bin/agentapiai.mjs detect api.example.com
node cli/bin/agentapiai.mjs reports
GitHub Action（只读，失败阈值可配）：action/README.md。没有发布到 Marketplace 前，用仓库内路径引用。
API 是公开数据的机器接口，不是认证或背书。发现数据错误请走 商家申诉；媒体引用请带数据版本与检测时间。