使用欧路词典OpenAPI，对生词本及笔记进行查询、修改等操作。

通过欧路词典OpenAPI管理生词本和笔记，实现查询、添加、修改、删除及语音评分功能。

欧路词典/法语助手/德语助手/西语助手 (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小时