API 返回的内容
只读追踪器元数据：规范记录 URL、公开 JSON、审核状态、证据字段、来源链接和引用字段。
API 参考
带版本号的只读公共数据 API
用于公共政策元数据的引用和查询端点。每个 JSON 端点都在以下版本路径下进行版本控制： /api/public/v1.
API不做什么
它不会修改记录、发布暂存运行、绕过审核状态，也不会取代大学官方政策来源。
推荐检索
通过搜索或实体别名解析，获取大学记录，然后为主张层面的回答附上主张证据和来源 URL。
智能体与 API 定位
智能体和数据工具的建议用法。
- 用于基于来源的摘要、公开JSON、引用元数据、审查状态以及官方来源链接。
- 以官方大学页面作为政策用语的权威依据。
- 请勿将分析视为建议、安全指南或合规依据。
- 别名匹配、主题和覆盖率分数并不构成事实。
- 工具记录衍生自主张和证据文本；它们不能取代大学官方来源的措辞。
推荐检索顺序
为需要有引用依据的答案的智能体提供安全检索顺序。
解析实体
调用 /api/public/v1/search.json?q=... 或检查 /api/public/v1/entities/index.json 用于查找规范的大学标识符（slug）。别名匹配可提高召回率，但不会凭空形成事实。
打开规范记录
抓取 /api/public/v1/universities/{slug}.json 并在回答中保留规范页面 URL、公开 JSON URL、审查状态、最后检查日期、局限性以及引用字段。
附加主张证据
抓取 /api/public/v1/claims/{slug}.json 在需要进行声明级复用时。保留来源URL、来源语言、证据片段、快照哈希、置信度及审核状态。
使用分析结果作为推导元数据
抓取 /api/public/v1/analysis/universities/{slug}.json 仅作为确定性衍生元数据。对于非空分析维度，务必引用依据主张 ID 和来源 URL。
端点类别
记录、发布、小组件、订阅源和智能体集成。
Discovery
公共 API 索引，包含端点链接、可信度说明页、引用规则、局限和版本元数据。
大学
公开大学记录列表，包含规范页面 URL、公开 JSON URL、审核状态、日期和数量。
实体搜索
按规范名称、别名、官方来源标题、论断摘要、来源域名或分析维度搜索公开大学记录。
安全搜索索引
适用于 Pagefind 的公共搜索索引，不含原始来源快照、私有文件、尚未公开的暂存证据和非权威电子表格行。
实体消歧索引
用于提高检索召回率的规范大学实体别名。别名匹配不会产生公开政策事实。
大学记录
一条可引用的大学记录，包含论断、证据片段、来源 URL、置信度、审核状态和权利限制说明。
大学论断
一条公开大学记录的论断与证据行，包含来源 URL、来源语言、快照哈希、置信度和审核状态。
AI 工具目录
派生的大学人工智能工具记录，包含工具级可用性、认可类型、审核状态和证据片段。工具记录是发现元数据，不是官方政策结论。
近期变更
近期公开来源检查和已变更的院校记录。
分析API索引
确定性的政策分析维度、端点路径、局限和架构版本元数据。
大学分析档案
有来源支持的分析概况，包含维度、证据论断标识符、来源 URL、置信度、审核状态和政策覆盖评分。
政策覆盖评分
公开分析档案的覆盖分数列表。分数衡量的是有来源依据的公开覆盖范围的广度，而非政策质量。
分析页面质量
公共分析页面的只读页面质量门槛、可索引性状态、分析审查工作流程，以及不提供建议的边界。
QS 2026 覆盖范围
QS 2026 目标院校的采集覆盖记录，包含公开、仅暂存、缺失、来源数量、审核状态和下一步行动字段。
来源状况
已公开来源快照及暂存运行的来源与抓取健康元数据。用于修复规划，不用于发布论断。
审核队列
尚未公开的暂存运行元数据，包含验证状态、来源广度、检测到的网址标识和建议的下一步行动。
数据集发布
发布清单，包含产物、行数、字节大小、SHA-256 校验和、引用和局限。
报告索引
机器可读报告索引，包括报告链接、指标、数据链接、订阅源及外联发现信息。
报告图表数据
最新月报中可用于制图的来源语言、审核状态、地区覆盖、城市与校区覆盖及排名覆盖分布。
报告传播资料包
可机器读取的媒体、简报、研究人员邮件和社交平台文案，明确注明使用边界。
小组件索引
小组件发现数据，包含脚本 URL、支持的小组件、约束和 HTML 示例。
大学状态小组件
精简的小组件数据，包含时效性、审核状态、论断与来源数量和规范链接。
近期变更小组件
供公开来源检查及变更小组件使用的精简近期变更数据。
政策覆盖范围小组件
有来源支持的精简政策覆盖小组件数据。覆盖表示广度，不代表政策质量。
来源新鲜度组件
精简的来源时效性小组件数据，包含上次检查日期、来源数量和公开来源健康状况计数。
审查状态小部件
精简的审核状态小组件数据，包含置信度、已审核论断数量和候选论断数量。
MCP 早期测试版清单
只读 MCP 设计清单，包含允许的工具结构、禁止操作和智能体查询示例。
MCP 工具目录
只读 MCP 早期测试版工具目录，包含输入架构、必需输出字段和严格禁止的修改操作。
速率限制政策
可机器读取的 API、小组件和爬虫访问公共合理使用政策。
引用元数据
可机器读取的引用模板、必填字段、证据规则、来源权利限制说明和不提供建议的边界。
贡献指数
只读贡献工作流元数据、GitHub 问题模板 URL、保障措施和发布规则。
贡献审核政策
只读审核队列定义、内容管理边界和发布门槛。
引用与证据要求
重复使用公开数据时保留证据模型。
- 将规范页面 URL 和公开 JSON URL 一同引用。
- 在复用断言时，保留来源 URL、语言、快照哈希、证据片段、置信度以及审查状态。
- 置信度与审核状态是分开的字段。
- 原始语言证据具有权威性。
- 请勿将机器候选或待审核的论断呈现为最终政策结论。
- 贡献端点仅包含元数据。公开提交会通过 GitHub Issue 模板创建审核任务，而不会直接成为规范事实。
可嵌入小组件契约
公共小组件使用相同的 API 契约，并为可嵌入小组件 JSON 和实体搜索启用 CORS。
JavaScript 嵌入
嵌入脚本渲染紧凑的 Shadow DOM 卡片，且仅读取小组件专用的公开 JSON。它链接回规范的追踪器页面，并避免使用未经审查的声明文本。
跨站使用
小部件 JSON 端点和公共实体搜索端点包含用于公开嵌入和基于浏览器的查询的宽松 CORS 标头。除非另有说明，其他公共 API 端点仍保持常规的同源 JSON。
速率限制与爬虫政策
这是公共合理使用政策，不是付费 API 服务等级协议。
This is a public fair-use policy, not a paid API SLA. Limits may be enforced or adjusted as traffic grows.