接口简介
查词语字典API提供词语释义查询服务，支持38万词库，免费稳定。用户通过提交词语，可获取详细解释（含拼音、释义、来源等）。适用于词典应用、教育平台等场景。
一、接口基本信息
- 请求地址：
https://cn.apihz.cn/api/zici/chaciyu.php - 请求方式：GET 或 POST
- 必填参数：
| 参数名 | 说明 | 示例值 |
| id | 用户ID（数字） | 88888888 |
| key | 通讯秘钥（字符串） | 88888888 |
| words | 待查询词语（需URL编码） | %E5%AE%87%E5%AE%99（宇宙） |
二、返回参数说明
| 参数名 | 说明 |
| code | 状态码（200成功，400失败） |
| msg | 错误提示（code=400时返回） |
| content | 词语释义（code=200时返回） |
| words | 查询的原始词语 |
成功响应示例：
json
复制
{ "code": 200, "words": "宇宙", "content": "yǔ zhòu-①天地万物的总称。语出战国时《庄子·齐物论》:..." }
失败响应示例：
json
复制
{"code":400,"msg":"通讯秘钥错误。"}
三、调用示例代码
1. PHP 示例（GET请求）
php
复制
<?php // 用户凭证 $id = "88888888"; // 替换为您的ID $key = "88888888"; // 替换为您的KEY $words = urlencode("宇宙"); // URL编码词语 // 构建请求URL $url = "https://cn.apihz.cn/api/zici/chaciyu.php?id=$id&key=$key&words=$words"; // 发送请求并获取响应 $response = file_get_contents($url); $result = json_decode($response, true); // 处理结果 if ($result['code'] == 200) { echo "词语: " . $result['words'] . "\n"; echo "释义: " . $result['content']; } else { echo "错误: " . $result['msg']; } ?>
2. Python 示例（POST请求）
python
运行
复制
import requests from urllib.parse import quote # 用户凭证 id = "88888888" # 替换为您的ID key = "88888888" # 替换为您的KEY words = quote("宇宙") # URL编码词语 # 请求参数 params = { "id": id, "key": key, "words": words } # 发送POST请求 url = "https://cn.apihz.cn/api/zici/chaciyu.php" response = requests.post(url, data=params) result = response.json() # 处理结果 if result['code'] == 200: print("词语:", result['words']) print("释义:", result['content']) else: print("错误:", result['msg'])
四、注意事项
- 身份验证：
- 使用公共ID/KEY（
88888888）会共享频次限制（每分钟限制次数）。 - 注册接口盒子账号获取个人ID/KEY，独享调用频次。
- 编码要求：
- 参数
words必须进行URL编码（如宇宙→%E5%AE%87%E5%AE%99），否则返回错误。
- 频次限制：
- 免费版每日调用无上限，但每分钟调用受账户等级限制（个人账户可提升频次）。
- 数据来源：
- 版权信息参考官方文档。
通过此API，开发者可快速集成词典功能至各类应用，高效稳定且无需复杂配置。
