新华字典词典成语歇后语查询

接口标识: xinhua 价格: 0.008 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

新华字典词典成语歇后语查询接口内置约 32 万条汉语语料，覆盖 1.6 万余单字、26 万余词语、3 万余成语与 1.4 万余歇后语，输入字、词、成语或歇后语关键词即可查得拼音、部首、笔画、释义、出处、例句与歇后语答案，同形多音字一次返回全部读音。未精确命中时自动给出前缀与包含两级模糊候选便于纠错联想，支持按类型限定查询。语料本地内置，毫秒级同步返回，适合字典类应用、语文教育、文本处理与内容校对。

详细介绍

![新华字典词典成语歇后语查询接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_xinhua__1794363338_10a92bf910ff.png)

查字、查词、查成语、查歇后语，字典类产品的体验好坏取决于语料是否权威齐全。新华字典词典成语歇后语查询接口把四类汉语语料收进一个查询入口。

## 接口概述
面向字典类应用、语文教育、文本处理与内容校对等场景，输入一个单字、词语、成语或歇后语关键词，接口在内置的汉语字词库中完成查询：单字返回拼音、部首、笔画、释义与古籍字形补充，成语返回拼音、释义、出处与例句，歇后语返回前后两段的答案，同形多音字一次返回全部读音与解释。未精确命中时自动降级为前缀、包含两级模糊候选，便于纠错与联想；也可限定数据类型缩小查询范围。语料数据本地内置，毫秒级同步返回。

## 核心能力
1. **四库合一**：字典单字、词典词语、成语、歇后语四类语料一个接口全覆盖。
2. **规模完备**：内置 1.6 万余单字、26 万余词语、3 万余成语与 1.4 万余歇后语。
3. **多音全收**：同形多音字精确命中时一次返回多条结果，一个读音一条。
4. **模糊候选**：未精确命中自动给出前缀候选，仍无则给包含候选，各至多 20 条。
5. **类型可控**：可限定 zi/ci/chengyu/xiehouyu 查询，留空则按数据自动识别。

## 产品优势
1. **接入简单**：单次 POST 传一个词即得结果，类型参数可选。
2. **响应迅速**：本地语料库查询，毫秒级同步返回。
3. **结构规范**：按类型整理好的结构化字段，拼音、部首、笔画、出处、例句一应俱全。
4. **稳定可靠**：语料数据内置，不依赖外部词典服务。
5. **体验友好**：命中模式随结果回显，前端可分层构建精确展示与「你是不是要找」联想。

## 效果展示
一句话理解：它就像随身带了一本「字典＋词典＋成语词典＋歇后语大全」四合一的合订本，翻到哪一页都能查得到。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| word | 一鸣惊人 | 要查询的字、词、成语或歇后语关键词，最长 60 字符 |
| type | chengyu | 可选，限定查成语；另可选 zi、ci、xiehouyu，留空自动识别 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 命中模式 | exact | `mode`，exact/prefix/contains/none |
| 命中类型 | ["chengyu"] | `detected_types`，实际命中的数据类型 |
| 结果条数 | 1 | `count` |
| 拼音 | yī míng jīng rén | `results[].pinyin`，单字与成语有 |
| 释义 | 比喻平时没有突出的表现，一下子做出惊人的成绩。 | `results[].explanation` |
| 出处 | 《史记·滑稽列传》：「不飞则已，一飞冲天；不鸣则已，一鸣惊人。」 | `results[].derivation`，仅成语 |
| 例句 | 这位选手平时默默无闻，决赛中一鸣惊人。 | `results[].example`，仅成语 |

API请求示例：

```text
POST /api/xinhua
word=一鸣惊人&type=chengyu
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "word": "一鸣惊人",
    "mode": "exact",
    "detected_types": ["chengyu"],
    "count": 1,
    "results": [
      {
        "type": "chengyu",
        "word": "一鸣惊人",
        "pinyin": "yī míng jīng rén",
        "explanation": "比喻平时没有突出的表现，一下子做出惊人的成绩。",
        "derivation": "《史记·滑稽列传》：「不飞则已，一飞冲天；不鸣则已，一鸣惊人。」",
        "example": "这位选手平时默默无闻，决赛中一鸣惊人。",
        "abbreviation": "ymjr"
      }
    ]
  },
  "request_id": "xinhua-demo-ymjr-0001"
}
```

查询词没有精确命中时，mode 返回 prefix 或 contains，candidates 给出至多 20 条候选词供前端做联想；完全无命中时 mode=none、结果数为 0。

## 应用场景
1. **字典应用**：字典、词典类 App 的核心查询能力，一个接口四类语料。
2. **语文教育**：课件与作业系统查生字部首笔画、成语释义与出处。
3. **文本处理**：阅读工具为生僻字与成语自动加注释义，辅助理解。
4. **内容校对**：出版与新媒体稿件中核对成语写法、歇后语前后段。
5. **文化问答**：知识问答与国风内容产品提供权威字词语料。

## 应用案例
一款面向中小学生的语文学习应用原先用多个开源词库拼接数据，成语出处与多音字时有缺失；接入接口后一次查询即得拼音、释义与出处，多音字全部读音一并返回，内容质量上了一个台阶。

一个阅读辅助工具需要在用户长按选词时弹出释义卡片，自建词库体积大、更新难；改用接口后配合模糊候选解决了用户输入错字的联想问题，长按查询保持毫秒级响应。

一家灯谜小游戏以成语和歇后语为题库，需要批量拉取词条并核对缩写；接口按类型限定查询加前缀候选正好适配出题与答案校验流程，题目编辑效率提升了一倍。

常见问题

Q：查询词没有精确命中会返回什么？

A：接口自动降级：先按前缀匹配给出候选（mode=prefix），仍无结果再按包含匹配给候选（mode=contains），candidates 各至多 20 条；完全无命中时 mode=none、count=0，前端可据此做「你是不是要找」联想。

Q：为什么查一个字返回了多条结果？

A：同形多音字的每个读音在语料库中各自成条，精确命中时会一次全部返回（至多 20 条），每条含该读音的拼音与释义，业务侧可全部展示或按需取用。

Q：四类数据的返回字段一样吗？

A：不一样，按类型各取所需：单字有拼音、部首、笔画、释义与古籍字形补充；词语只有词与释义；成语有拼音、释义、出处、例句与缩写；歇后语返回前半（word）与后半答案（answer）。results 中每条带 type 字段标明类型。

字典词典成语歇后语汉字查询语文学习

接口地址： https://www.phpwc.cn/api/xinhua

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`word`	string	必填	-	查询目标：单字/词语/成语/歇后语关键词，如裞、宸纶、阿鼻地狱、外甥打灯笼
`type`	string	选填	-	数据类型：zi=字典单字、ci=词典词语、chengyu=成语、xiehouyu=歇后语，留空则自动识别

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`word`	string	查询词
`mode`	string	命中模式：exact=精确命中、prefix=前缀候选、contains=包含候选、none=无命中
`detected_types`	array	实际命中的数据类型列表（zi/ci/chengyu/xiehouyu）
`count`	int	结果或候选条数
`results`−	array	精确命中条目（mode=exact 时返回；同形多音字为多条）
`type`	string	条目类型：zi/ci/chengyu/xiehouyu
`word`	string	字/词/成语，或歇后语前半
`pinyin`	string	拼音（单字、成语有；词语、歇后语无）
`radicals`	string	部首（仅单字）
`strokes`	string	笔画（仅单字）
`explanation`	string	释义（单字/词语/成语），歇后语时为空白
`answer`	string	歇后语后半答案（仅歇后语）
`oldword`	string	古籍字形/异体（仅单字）
`more`	string	说文解字等补充（仅单字）
`derivation`	string	成语出处（仅成语）
`example`	string	成语例句（仅成语）
`abbreviation`	string	成语简体/缩写（仅成语）
`candidates`−	array	模糊候选（mode=prefix/contains 时返回）
`type`	string	候选类型
`word`	string	候选词
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试