ShenaAI查出处 ↗

开发者文档 · 公开选段

查出处免费 API

查询《论语》《道德经》《庄子》首批选段，返回可核对的原文与出处。

01　创建查出处 Key

首次使用请在主站点击「注册」，注册成功后在同一个浏览器回到本页。已有账号可直接登录。每个账号与空间共享每个 UTC 自然月 1,000 次基础免费调用，每把 Key 每分钟 30 次。查出处 Key 仅用于下列公开选段接口。

Key 只在创建时显示。请保存到服务端的环境变量。可在主站 API 控制台查看用量或吊销密钥。

02　检索原文

GET /api/v3/citations/search 接收 q（2 至 100 字符）与 limit（1 至 10，默认 6）。无命中返回空列表，成功搜索计一次调用。

curl --get 'https://shenaai.cn/api/v3/citations/search' \
  --header "Authorization: Bearer ${SHENA_CITATION_KEY}" \
  --data-urlencode 'q=上善若水' \
  --data-urlencode 'limit=3'

响应包括 query、results、corpus_version 和 notice。每条结果包含 id、title、locator、edition、text、source_url、sha256 和 citation。

03　按段落 ID 取原文

GET /api/v3/citations/passages/ddj-08 使用同一鉴权头，返回 result 与语料版本。成功读取计一次。

HTTP 401 表示 Key 缺失或失效，404 表示段落不存在，422 表示参数有误，429 表示限流或配额已满。遇到限速请遵守 Retry-After。

语料和引用

首批 11 条古籍原文节选，标点经整理。复用时建议保留来源、版本和篇章。第三方校勘、注译和页面素材按其自身许可处理。