# 静态 JSON 与 CSV API

> 以 JSON 或 CSV 读取精选目录：1,196 项资源、207 篇论文、分类、未审核候选与最近 30 天的变更。所有文件均为静态内容，可直接下载。

- HTML: <https://awesomerea.org/zh/api/>
- 文件索引: <https://awesomerea.org/api/v1/index.json>
- JSON Schema: <https://awesomerea.org/api/v1/schema.json>

## 端点

- [resources.json](https://awesomerea.org/api/v1/resources.json) (1,196; CSV: https://awesomerea.org/api/v1/resources.csv): 精选资源：稳定 ID、中英文名称与说明、使用条件、证据与复核日期。
- [papers.json](https://awesomerea.org/api/v1/papers.json) (207; CSV: https://awesomerea.org/api/v1/papers.csv): 研究文献：标识、日期及其依据、研究边界与来源；作者省略的论文不列姓名。
- [categories.json](https://awesomerea.org/api/v1/categories.json) (69; CSV: https://awesomerea.org/api/v1/categories.csv): 精选分类、分区、类型、目标与关联及其数量，以及仓库分类。
- [candidates.json](https://awesomerea.org/api/v1/candidates.json) (2,000; CSV: https://awesomerea.org/api/v1/candidates.csv): 未审核的自动发现与关注来源线索，按时间从新到旧。
- [changes.json](https://awesomerea.org/api/v1/changes.json) (1,458; CSV: https://awesomerea.org/api/v1/changes.csv): generated_at 之前 30 天内的新增、后续来源复核与发现批次。

## 版本、更新与复用

每个文件都带有 version（1.0.0）、generated_at 以及所遵循的 schema 定义；CSV 每行重复 version 与 generated_at。ID 即目录的稳定 ID。

generated_at（2026-11-06T14:32:13Z）是数据中最新的记录时间而非构建时间，因此同一提交总能重建出相同的文件。目录每次变化时文件随之更新：每个合并的 PR，以及每小时一次新增记录的自动发现入库。

响应允许任意来源（CORS *）并带 ETag。无需密钥或账号；请缓存并发送 If-None-Match。

精选资源与论文均经来源复核：说明已依据一手文档核对。

```sh
curl -s https://awesomerea.org/api/v1/resources.json | jq '.resources[] | select(.targets | index("protocol")) | {id, name, entry_url}'
```