Shuge Open Data · API v1.1

书格数字化资源 API

提供数字古籍、书画、碑拓、影像、地图与档案的公开 JSON 数据。可直接读取静态快照，也可使用目录式接口组合筛选。

静态 JSON

适合缓存、镜像与批量读取

总索引

包含记录总数、分类统计、分页入口和参数查询能力说明。

GET /api/index.json

最近更新

快速获取最近更新的 100 条记录，或读取完整更新时间分页。

GET /api/latest.json

聚合统计

按资源类型、书籍分类、版权协议、馆藏机构和责任人性别汇总。

GET /api/facets.json

专题列表

页码从 1 开始

接口内容
/api/cat_{类型}_p{page}.json按书籍、字画、碑拓、影像、地图、档案等资源类型分页。
/api/book_{分类}_p{page}.json按经部、史部、子部、集部、丛书部、近现代分页。
/api/updated_p{page}.json全部记录按更新时间从新到旧排列。
/api/series_p{page}.json系列资源及多卷本列表。
/api/downloadable_p{page}.json包含下载链接的资源列表。
/api/{resource_id}.json通过资源标识 ID 获取单条完整记录。

参数查询

GET /query/ · 默认 20 条，最多 100 条

参数用途
resource_id 或 id精确获取一条完整记录。
q搜索 ID、题名、别名、责任人、版本、馆藏机构和提要。
type按资源类型筛选，例如“书籍”或“字画”。
book_category按书籍分类筛选，例如“经部”或“集部”。
license / collection匹配版权协议或馆藏机构。
gender按责任人性别筛选：男性、女性或未知。
is_series / has_download使用 1 或 0 筛选系列及下载状态。
updated_after / updated_before按日期或 ISO 8601 时间限定更新范围。
sortupdated_desc、updated_asc、created_desc、created_asc、title_asc、title_desc。
viewsummary 返回摘要字段；full 返回完整字段。
include_facets设为 1 时附带当前结果的分类统计。
page / per_page设置页码与每页记录数。

查询示例

点击即可查看 JSON 响应

GET /query/?q=祭侄文稿 GET /query/?gender=女性&sort=updated_desc GET /query/?type=书籍&book_category=集部&sort=updated_desc GET /query/?has_download=1&view=full&page=1&per_page=20 GET /query/?updated_after=2026-01-01&include_facets=1
参数查询接口为公开只读接口，支持跨域 GET 请求。日期时间按照 UTC 存储和筛选；中文及空格等字符请在程序调用时进行 URL 编码。