添加闪卡 (addRiffCards)

功能描述

此 API 端点 POST /api/riff/addRiffCards 用于将指定的块（Blocks）制作为闪卡并添加到指定的闪卡包（Deck）中。

一个块可以被添加到多个闪卡包中。

请求参数

请求体必须是 JSON 格式，包含以下参数：

• deckID (string): 必填。目标闪卡包的 ID。
• blockIDs (array of strings): 必填。要添加为闪卡的块 ID 列表。

请求示例:

{
  "deckID": "20231027111111-abcdefg",
  "blockIDs": [
    "20240101100000-hijklmn",
    "20240102110000-opqrstu"
  ]
}
            

响应结果

成功的请求将返回一个 JSON 对象，code 为 0，data 字段包含更新后的目标闪卡包的详细信息。

{
  "code": 0,
  "msg": "",
  "data": {
    "id": "20231027111111-abcdefg", // 卡包 ID
    "name": "我的第一个卡包", // 卡包名
    "box": "20210816155902-kpf7v8m", // 所属笔记本 ID (Box ID)
    "cardCount": 15, // 卡包内卡片总数
    "dueCardCount": 3, // 到期需复习卡片数
    "newCardCount": 5, // 新卡数量
    "todayReviewedCardCount": 2, // 今日已复习卡片数
    "conf": { // 卡包配置
      // ... 具体配置项 ...
    }
  }
}
            

• code: 0 表示成功，非 0 表示失败（例如 deckID 无效、blockIDs 包含无效 ID 等）。
• msg: 错误信息（如果 code 非 0）。
• data: 更新后的闪卡包信息对象，包含卡包 ID (id), 名称 (name), 所属笔记本 ID (box), 卡片总数 (cardCount), 到期卡片数 (dueCardCount), 新卡数 (newCardCount), 今日已复习数 (todayReviewedCardCount) 以及卡包配置 (conf) 等。

在线测试

您可以在下方输入闪卡包 ID 和要添加的块 ID 列表进行在线测试。