公共 API

EvalRank 提供七条匿名的、以回执为先的路由。每一份成功响应文档和 RFC 9457 错误都会对照固定的公开契约进行校验。

POST /v1/decisions 默认使用 share=false，因此返回的回执不会被保留。使用 share=true 时，相同的查询会以内容寻址的回执 ID 保留下来，并可通过 URL 重放。

能力排名始终按可比的排名分组分开呈现。一次决策要么返回有依据的头部集合，要么选择弃权；绝不会凭空编造一个唯一的赢家。

路由

  • POST /v1/decisions

    对一条精确的决策查询进行评估。只有当你需要保留一份可公开安全分享的回执时，才加上 share=true。

  • GET /v1/decisions/{receipt_id}

    通过内容寻址的 ID 重放已保留的回执。

  • GET /v1/benchmark-health

    查看处于活跃、预览和不可用状态的基准覆盖情况，而不轻易判定某个来源已失效。

  • GET /v1/use-cases

    查阅规范的能力单元目录。

  • GET /v1/leaderboard/{use_case}

    查看某个规范能力单元对应的排名分组，不把不同类别的系统强行拉平比较。

  • GET /v1/entities/{entity_type}/{slug}

    查看某一精确的已评估配置及其护照、排名和引用来源。

  • GET /v1/compare

    在同一排名分组和同一快照下，比较两到四个配置。

阅读方法论