欧路词典/法语助手/德语助手/西语助手 (Eudic OpenAPI)
本技能提供 欧路词典/法语助手/德语助手/西语助手OpenAPI 的调用能力，用于管理生词本、用户语料、笔记和语音评分等功能。
何时使用 (触发条件)
当用户提出以下类型的请求时，应使用本技能：
- "查看我的生词本"
- "添加单词到生词本"
- "查询某个单词"
- "查询我的语料"
- "按最近N天或是否已收藏筛选语料"
- "批量查询语料单词详情"
- "添加笔记"
- "查看笔记"
- "删除生词本/单词/笔记"
环境配置
获取 API Token
- 访问 https://my.eudic.net/OpenAPI/Authorization 获取 API Token
- 格式：
NIS {token}
支持的语言与应用名称
| 语言 | language 参数 | 应用名称 |
|---|---|---|
| 英语 | en | 欧路词典 |
| 法语 | fr | 法语助手 |
| 德语 | de | 德语助手 |
| 西班牙语 | es | 西语助手 |
注意: 调用 API 时需要通过 language query 参数指定语言。
核心功能与用法
1. 获取所有生词本
# language: en=欧路词典, fr=法语助手, de=德语助手, es=西语助手
curl -s "https://api.frdic.com/api/open/v1/studylist/category?language=en" \
-H "Authorization: NIS {Token}"
参数:
language: en/fr/de/es (必填)
返回: 生词本列表 (id, language, name, add_time)
2. 添加新生词本
curl -s -X POST "https://api.frdic.com/api/open/v1/studylist/category" \
-H "Authorization: NIS {Token}" \
-H "Content-Type: application/json" \
-d '{"language": "en", "name": "新单词本"}'
参数:
language: en/fr/de/es (必填)name: 生词本名称 (必填)
3. 重命名生词本
curl -s -X PATCH "https://api.frdic.com/api/open/v1/studylist/category" \
-H "Authorization: NIS {Token}" \
-H "Content-Type: application/json" \
-d '{"id": "生词本ID", "language": "en", "name": "新名称"}'
参数:
id: 生词本ID (必填)language: en/fr/de/es (必填)name: 新名称 (必填)
4. 删除生词本
curl -s -X DELETE "https://api.frdic.com/api/open/v1/studylist/category" \
-H "Authorization: NIS {Token}" \
-H "Content-Type: application/json" \
-d '{"id": "生词本ID", "language": "en", "name": "生词本名称"}'
5. 获取生词本单词
curl -s "https://api.frdic.com/api/open/v1/studylist/words?language=en&category_id=0&page=1&page_size=100" \
-H "Authorization: NIS {Token}"
参数:
language: en/fr/de/es (必填)category_id: 生词本ID (必填)page: 页码 (可选，默认1)page_size: 每页数量 (可选，默认100)
返回: 单词列表 (word, phon, exp, add_time, star, context_line)
6. 批量添加单词
curl -s -X POST "https://api.frdic.com/api/open/v1/studylist/words" \
-H "Authorization: NIS {Token}" \
-H "Content-Type: application/json" \
-d '{"language": "en", "category_id": "0", "words": ["apple", "banana", "orange"]}'
参数:
language: en/fr/de/es (必填)category_id: 生词本ID (必填)words: 单词数组 (必填)
7. 删除单词
curl -s -X DELETE "https://api.frdic.com/api/open/v1/studylist/words" \
-H "Authorization: NIS {Token}" \
-H "Content-Type: application/json" \
-d '{"language": "en", "category_id": "0", "words": ["apple"]}'
8. 新增单个单词
curl -s -X POST "https://api.frdic.com/api/open/v1/studylist/word" \
-H "Authorization: NIS {Token}" \
-H "Content-Type: application/json" \
-d '{"language": "en", "word": "hello", "star": 2, "context_line": "Hello, how are you?"}'
参数:
language: en/fr/de/es (必填)word: 单词 (必填)star: 星级 1-5 (可选)context_line: 语境例句 (可选)category_ids: 分组ID列表 (可选)
9. 查询单词
curl -s "https://api.frdic.com/api/open/v1/studylist/word?language=en&word=hello" \
-H "Authorization: NIS {Token}"
参数:
language: en/fr/de/es (必填)word: 单词 (必填)
返回: 单词详情
10. 获取笔记列表
curl -s "https://api.frdic.com/api/open/v1/studylist/notes?page=0&page_size=100" \
-H "Authorization: NIS {Token}"
参数:
page: 页码 (可选，默认0)page_size: 每页数量 (可选，默认100)
返回: 笔记列表 (word, note, language, add_time)
11. 查询用户语料列表
curl -s "https://api.frdic.com/api/open/v1/studylist/vocab_entries?language=en&recent_days=30&is_favorited=true&page=0&page_size=20" \
-H "Authorization: NIS {Token}"
参数:
language: en/fr/de/es (必填)recent_days: 最近N天 (可选，小于等于0表示不筛选)is_favorited: 是否已收藏到生词本 (可选，true只看已收藏，false只看未收藏)page: 页码 (可选，默认-1；-1表示不分页)page_size: 每页数量 (可选，默认100；仅在page >= 0时生效)
返回: 语料列表 (word, exp, add_time, rating, contexts)
12. 批量查询用户语料单词详情
curl -s -X POST "https://api.frdic.com/api/open/v1/studylist/vocab_words" \
-H "Authorization: NIS {Token}" \
-H "Content-Type: application/json" \
-d '{"language": "en", "words": ["action", "amplify"]}'
参数:
language: en/fr/de/es (必填)words: 单词数组 (必填，会自动忽略空白并去重)
返回: 单词详情列表 (word, exp, contexts)
13. 获取单个单词笔记
curl -s "https://api.frdic.com/api/open/v1/studylist/note?word=hello" \
-H "Authorization: NIS {Token}"
参数:
word: 单词 (必填)
返回:单词笔记不存在会返回404.存在会返回单词内容
14. 新增笔记
curl -s -X POST "https://api.frdic.com/api/open/v1/studylist/note" \
-H "Authorization: NIS {Token}" \
-H "Content-Type: application/json" \
-d '{"word": "hello", "note": "这是笔记内容"}'
参数:
word: 单词 (必填)note: 笔记内容 (必填)
15. 删除笔记
curl -s -X DELETE "https://api.frdic.com/api/open/v1/studylist/note" \
-H "Authorization: NIS {Token}" \
-H "Content-Type: application/json" \
-d '{"word": "hello"}'
响应码
| 响应码 | 含义 |
|---|---|
| 200 | 成功 (GET) |
| 201 | 创建/修改成功 (POST/PATCH) |
| 204 | 删除成功 (DELETE) |
| 400 | 参数错误 |
| 401 | 授权认证失败 |
| 403 | 访问过于频繁 |
流量限制
| 周期 | 限制次数 | 封停时间 |
|---|---|---|
| 1分钟 | 30次 | 1小时 |
| 30分钟 | 500次 | 24小时 |