📋 平台概览
API 开放平台 v2 提供丰富的语言学习数据接口。
📌 基础地址：
https://cidian.aiensdc.vip/api/v1🔐 鉴权方式
所有接口均需通过 API Key 验证。
方式一：请求头（推荐）
GET /api/v1/query.php?word=hello X-API-Key: your_api_key_here
方式二：URL 参数
GET /api/v1/query.php?word=hello&api_key=your_api_key_here
💡 频率限制：每个 API Key 每日默认 1000 次，每日 00:00 自动重置。
📡 接口列表
按分类浏览所有 API 接口，点击"试一下"可在线测试。
📖 词典
GET
/query.php
— 单词查询
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| word | string | 必填 | 要查询的单词 |
| api_key | string | 可选 | API Key |
请求示例
试一下
curl -X GET "https://cidian.aiensdc.vip/api/v1/query.php?api_key=YOUR_KEY"
响应示例
{
"code": 0,
"message": "success",
"data": { ... },
"api_version": "v2.0",
"timestamp": "2026-09-08T15:13:11+08:00"
}
GET
/search.php
— 模糊搜索
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| q | string | 必填 | 搜索关键词 |
| limit | int | 可选 | 每页数量，默认20 |
| page | int | 可选 | 页码，默认1 |
请求示例
试一下
curl -X GET "https://cidian.aiensdc.vip/api/v1/search.php?api_key=YOUR_KEY"
响应示例
{
"code": 0,
"message": "success",
"data": { ... },
"api_version": "v2.0",
"timestamp": "2026-09-08T15:13:11+08:00"
}
GET
/word.php
— 词条详情
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | int | 必填 | 词条ID |
请求示例
试一下
curl -X GET "https://cidian.aiensdc.vip/api/v1/word.php?api_key=YOUR_KEY"
响应示例
{
"code": 0,
"message": "success",
"data": { ... },
"api_version": "v2.0",
"timestamp": "2026-09-08T15:13:11+08:00"
}📚 成语
GET
/idioms.php
— 成语查询
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 必填 | search/detail/random/category |
| q | string | 可选 | 搜索关键词(action=search时) |
| id | int | 可选 | 成语ID(action=detail时) |
| count | int | 可选 | 随机数量(action=random时) |
| category | string | 可选 | 分类(action=category时) |
请求示例
试一下
curl -X GET "https://cidian.aiensdc.vip/api/v1/idioms.php?api_key=YOUR_KEY"
响应示例
{
"code": 0,
"message": "success",
"data": { ... },
"api_version": "v2.0",
"timestamp": "2026-09-08T15:13:11+08:00"
}🧩 谜语
GET
/riddles.php
— 谜语查询
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 必填 | list/random/detail |
| category | string | 可选 | 谜语分类(action=list时) |
| count | int | 可选 | 随机数量(action=random时) |
| id | int | 可选 | 谜语ID(action=detail时) |
| page | int | 可选 | 页码(action=list时) |
请求示例
试一下
curl -X GET "https://cidian.aiensdc.vip/api/v1/riddles.php?api_key=YOUR_KEY"
响应示例
{
"code": 0,
"message": "success",
"data": { ... },
"api_version": "v2.0",
"timestamp": "2026-09-08T15:13:11+08:00"
}😏 歇后语
GET
/xiehouyu.php
— 歇后语查询
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 必填 | list/random/search |
| category | string | 可选 | 分类(action=list时) |
| q | string | 可选 | 搜索词(action=search时) |
| count | int | 可选 | 随机数量(action=random时) |
| page | int | 可选 | 页码 |
请求示例
试一下
curl -X GET "https://cidian.aiensdc.vip/api/v1/xiehouyu.php?api_key=YOUR_KEY"
响应示例
{
"code": 0,
"message": "success",
"data": { ... },
"api_version": "v2.0",
"timestamp": "2026-09-08T15:13:11+08:00"
}📜 诗词
GET
/poetry.php
— 诗词查询
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 必填 | list/search/detail/random |
| dynasty | string | 可选 | 朝代(action=list时) |
| q | string | 可选 | 搜索词(action=search时) |
| id | int | 可选 | 诗词ID(action=detail时) |
| count | int | 可选 | 随机数量(action=random时) |
请求示例
试一下
curl -X GET "https://cidian.aiensdc.vip/api/v1/poetry.php?api_key=YOUR_KEY"
响应示例
{
"code": 0,
"message": "success",
"data": { ... },
"api_version": "v2.0",
"timestamp": "2026-09-08T15:13:11+08:00"
}🅗 汉字
GET
/hanzi.php
— 汉字查询
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 必填 | search/detail/radical |
| q | string | 可选 | 搜索词(action=search时) |
| char | string | 可选 | 汉字(action=detail时) |
| radical | string | 可选 | 部首(action=radical时) |
| page | int | 可选 | 页码 |
请求示例
试一下
curl -X GET "https://cidian.aiensdc.vip/api/v1/hanzi.php?api_key=YOUR_KEY"
响应示例
{
"code": 0,
"message": "success",
"data": { ... },
"api_version": "v2.0",
"timestamp": "2026-09-08T15:13:11+08:00"
}🏘️ 社区
GET
/community.php
— 社区数据
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 必填 | communities/posts/hot_posts |
| community_id | int | 可选 | 社区ID(action=posts时) |
| limit | int | 可选 | 数量限制 |
| page | int | 可选 | 页码 |
请求示例
试一下
curl -X GET "https://cidian.aiensdc.vip/api/v1/community.php?api_key=YOUR_KEY"
响应示例
{
"code": 0,
"message": "success",
"data": { ... },
"api_version": "v2.0",
"timestamp": "2026-09-08T15:13:11+08:00"
}📋 词表
GET
/wordlists.php
— 词表查询
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 必填 | list/words |
| list_id | int | 可选 | 词表ID(action=words时) |
| page | int | 可选 | 页码 |
| limit | int | 可选 | 每页数量 |
请求示例
试一下
curl -X GET "https://cidian.aiensdc.vip/api/v1/wordlists.php?api_key=YOUR_KEY"
响应示例
{
"code": 0,
"message": "success",
"data": { ... },
"api_version": "v2.0",
"timestamp": "2026-09-08T15:13:11+08:00"
}⚠️ 错误码
统一的 JSON 响应格式，包含 code、message、data 字段。
| 状态码 | HTTP | 说明 |
|---|---|---|
| 0 | 200 | ✅ 成功 |
| 400 | 400 | ⚠️ 参数错误 |
| 401 | 401 | 🔐 未授权 |
| 403 | 403 | 🚫 禁止访问 |
| 404 | 404 | 🔍 未找到 |
| 500 | 500 | 💥 服务器错误 |