欧路词典/法语助手/德语助手/西语助手 (Eudic OpenAPI)#

本技能提供 欧路词典/法语助手/德语助手/西语助手OpenAPI 的调用能力，用于管理生词本、用户语料、笔记和语音评分等功能。

何时使用 (触发条件)#

当用户提出以下类型的请求时，应使用本技能：

• "查看我的生词本"
• "添加单词到生词本"
• "查询某个单词"
• "查询我的语料"
• "按最近N天或是否已收藏筛选语料"
• "批量查询语料单词详情"
• "添加笔记"
• "查看笔记"
• "删除生词本/单词/笔记"

环境配置#

获取 API Token#

1. 访问 https://my.eudic.net/OpenAPI/Authorization 获取 API Token
2. 格式： NIS {token}

支持的语言与应用名称#

语言language 参数应用名称英语en欧路词典法语fr法语助手德语de德语助手西班牙语es西语助手

注意: 调用 API 时需要通过 language query 参数指定语言。

---

核心功能与用法#

1. 获取所有生词本#

bash

# 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. 添加新生词本#

bash

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. 重命名生词本#

bash

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. 删除生词本#

bash

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. 获取生词本单词#

bash

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. 批量添加单词#

bash

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. 删除单词#

bash

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. 新增单个单词#

bash

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. 查询单词#

bash

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. 获取笔记列表#

bash

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. 查询用户语料列表#

bash

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. 批量查询用户语料单词详情#

bash

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. 获取单个单词笔记#

bash

curl -s "https://api.frdic.com/api/open/v1/studylist/note?word=hello" \
  -H "Authorization: NIS {Token}"

参数:

• word: 单词 (必填)

返回:单词笔记不存在会返回404.存在会返回单词内容#

14. 新增笔记#

bash

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. 删除笔记#

bash

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小时