歇后语 API

随机返回歇后语（谜面 + 谜底），可按关键字搜索；内置 114 条人工筛选的民间传统歇后语，另可选用约 1.25 万条新华词典歇后语（已过滤歧视性内容）

数据来源：本地内置（民间传统歇后语）+ 新华词典开源数据 chinese-xinhua（MIT）

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

随机歇后语，可按关键字搜索

GET /api/xiehouyu

请求参数

  • keyword：关键字，同时匹配谜面和谜底；不传则从全部歇后语中随机，示例 猪八戒
  • scope：抽取范围：curated=人工筛选的 114 条；all=再加上新华词典歇后语（约 1.25 万条，已过滤拿残障、疾病、性别、地域、民族打趣的条目，未逐条人工校对），示例 all
  • count：条数，1~10 的整数；同一次返回的条目互不重复，示例 3

返回字段

  • keyword（string|null）：实际使用的关键字（已去掉空白）；未传时为 null
  • scope（string）：实际使用的抽取范围：curated 或 all。编号 1~114 为人工筛选数据，更大的编号来自新华词典
  • matched（number）：符合条件的歇后语总数（未传 keyword 时为所选范围的全部条数）；为 0 时 items 为空
  • count（number）：实际返回的条数，等于 items 的长度（可能少于请求的 count）
  • items（array）：歇后语列表，随机顺序，互不重复
  • items[].id（number）：歇后语编号（固定不变）；1~114 为人工筛选数据，更大的来自新华词典
  • items[].riddle（string）：谜面（前半句），如“外甥打灯笼”
  • items[].answer（string）：谜底（后半句），谐音双关的在括号里注明本字，如“照舅（旧）”；新华词典数据有多种说法时用“；”分隔，括号里可能是谐音字（如“规定（龟腚）”）或释义
  • items[].text（string）：完整的一句，格式为“谜面——谜底”