本文介绍接口盒子提供的免费成语字典API，该接口可查询超过3万条成语的详细解释、同义词、反义词等信息。
接口基本信息
- 请求地址：
https://cn.apihz.cn/api/zici/chacy.php - 请求方式：GET/POST
- 请求参数：
| 参数名 | 必填 | 说明 |
| id | 是 | 用户中心数字ID |
| key | 是 | 用户中心通讯秘钥 |
| words | 是 | 要查询的成语（需URL编码） |
- 返回参数：
- json
- 复制
{ "code": 状态码(200成功/400错误), "msg": "提示信息", "words": "成语名称", "bushou": "首字部首", "shouzi": "首字", "pingyin": "拼音", "jieshi": "解释", "chuchu": "出处", "tongyi": "同义词", "fanyi": "反义词", "liju": "例句", "yinzheng": "印证", "yufa": "语法", "en": "英文翻译" }
📌 重要提示：
示例中的公共ID/KEY（88888888）有频次限制，请注册账号获取独享密钥
调用示例
1. GET请求示例
直接在浏览器访问（需替换真实ID/KEY）：
bash
复制
https://cn.apihz.cn/api/zici/chacy.php?id=您的ID&key=您的KEY&words=守株待兔
2. PHP调用示例
php
复制
<?php $id = "您的ID"; $key = "您的KEY"; $word = urlencode("刻舟求剑"); // URL编码成语 $url = "https://cn.apihz.cn/api/zici/chacy.php?id=$id&key=$key&words=$word"; // 发送GET请求 $response = file_get_contents($url); $result = json_decode($response, true); // 处理结果 if ($result['code'] == 200) { echo "成语：" . $result['words'] . "\n"; echo "解释：" . $result['jieshi'] . "\n"; echo "同义词：" . $result['tongyi']; } else { echo "错误：" . $result['msg']; } ?>
3. Python调用示例
python
运行
复制
import requests from urllib.parse import quote id = "您的ID" key = "您的KEY" word = quote("画蛇添足") # URL编码成语 # GET请求示例 url = f"https://cn.apihz.cn/api/zici/chacy.php?id={id}&key={key}&words={word}" response = requests.get(url) data = response.json() if data['code'] == 200: print(f"成语：{data['words']}") print(f"反义词：{data['fanyi']}") print(f"英文翻译：{data['en']}") else: print("错误：", data['msg']) # POST请求示例（推荐） params = {"id": id, "key": key, "words": "画蛇添足"} response = requests.post(url, data=params)
返回结果示例
成功响应：
json
复制
{ "code": 200, "words": "焕然一新", "bushou": "火", "shouzi": "焕", "pingyin": "huàn rán yī xīn", "jieshi": "焕然：鲜明光亮的样子。改变旧面貌，出现崭新的气象。", "chuchu": "唐·张彦远《历代名画记·论鉴识收藏购求阅玩》...", "tongyi": "面目一新，耳目一新，焕然如新", "fanyi": "依然如故，依然故我", "liju": "依中国法度，造作旗帜大纛纛，焕然一新。", "yinzheng": "本作“焕然如新”。谓光彩耀眼，好像新的一样...", "yufa": "偏正式；作谓语、宾语；含褒义", "en": "(1) [take on an entirely new look]∶光彩夺目..." }
错误响应：
json
复制
{"code":400, "msg":"通讯秘钥错误"}
使用须知
- 认证机制：必须使用注册获取的ID和KEY
- 编码要求：成语参数需进行URL编码（Python用
urllib.parse.quote，PHP用urlencode） - 请求限制：公共KEY限频，私有KEY无每日上限
- 数据版权：参考官方文档
此接口适合集成到词典应用、写作辅助工具或教育类程序中，提供权威的成语解析服务。
