开放 API

汉语典向开发者免费开放部分数据接口：汉字 14,809 字、成语 30,893 条、词语 262,530 条、唐诗宋词 85,059 首。只读 GET 接口，无需注册与密钥，支持跨域调用（CORS），响应 JSON。

通用约定

基础地址：https://hanyudian.com

限流：同一 IP 每分钟 60 次，超限返回 429 与 Retry-After 头。

诗词类接口支持 lang=zh-Hant 返回繁体原文（默认简体）。

错误格式：{ "error": "错误码", "message": "说明" }

汉字

GET/api/v1/zi/{字}

单字详情：拼音（多音）、笔画、部首、繁体、五笔、注音、释义等。

curl "https://hanyudian.com/api/v1/zi/世"

{ "char": "世", "pinyin": ["shì"], "strokes": 5,
  "radical": "一", "traditional": "世", ... }

成语与词语

GET/api/v1/chengyu/{成语}

成语详情：拼音、释义、出处、例句。

curl "https://hanyudian.com/api/v1/chengyu/一举两得"

{ "word": "一举两得", "pinyin": "yī jǔ liǎng dé", ... }

GET/api/v1/ciyu/{词语}

词语释义（新华词典）。

curl "https://hanyudian.com/api/v1/ciyu/中国"

{ "word": "中国", "definition": "...", ... }

诗词

GET/api/v1/poems/search

诗词全文搜索：按标题、作者、正文匹配，支持分页。

参数	说明
q	查询词，1-30 字（必填）
page	页码，默认 1
size	每页条数，默认 20，最大 50
lang	zh-Hans（默认）/ zh-Hant

curl "https://hanyudian.com/api/v1/poems/search?q=床前明月光"

{ "total": 1, "items": [
  { "kind": "tang", "id": 9240, "title": "静夜思", "author": "李白",
    "line": "床前明月光，疑是地上霜。" } ] }

GET/api/v1/poems/random

随机诗词。带 char 参数即飞花令（限定含某字），带 seed 参数即确定性结果（每日一诗场景）。

参数	说明
char	限定含此单个汉字（可选）
seed	任意字符串，同种子同结果（可选）
lang	zh-Hans（默认）/ zh-Hant

curl "https://hanyudian.com/api/v1/poems/random?char=春"

{ "title": "春晓", "author": "孟浩然",
  "paragraphs": ["春眠不觉晓，处处闻啼鸟。", ...],
  "poolSize": 5862 }

GET/api/v1/poems/{tang|ci}/{id}

按 ID 取诗词全文（标题、作者、分段正文）。

参数	说明
lang	zh-Hans（默认）/ zh-Hant

curl "https://hanyudian.com/api/v1/poems/tang/9240"

{ "title": "静夜思", "author": "李白",
  "paragraphs": ["床前明月光，疑是地上霜。", ...] }

站点统计

GET/api/v1/stats

全站各板块数据量统计。

curl "https://hanyudian.com/api/v1/stats"

{ "hanzi": 22258, "idiom": 31648, "poemTang": 61098, ... }

使用条款与署名

接口返回数据均来自开放数据源，各数据源的许可条款见本站开放数据许可页。

在应用中使用本接口时，请注明数据来源于汉语典（hanyudian.com）并保留响应中的 link/source 字段链接。

接口仅供合理频率的正当用途，禁止抓站式批量导出；大规模数据需求请直接使用原始开源数据集。