桃李中文-Taoli-Cloud
  1. 【运营控制台】学词章节
桃李中文-Taoli-Cloud
  • roadmap
    • 【运营控制台】专项课文章
      • 查询文章列表
      • 文章详细信息
      • 新增文章
      • 修改文章
      • 删除文章
      • 修改文章状态
      • 操作检测
      • 查词标记
    • 【运营控制台】HSK课程直播录播相关
      • 添加或保存直播计划
      • 删除直播计划
    • 【运营控制台】首页课程类型配置
      • 查询首页课程类型配置列表
      • 首页课程类型配置详细信息
      • 新增首页课程类型配置
      • 修改首页课程类型配置
      • 删除首页课程类型配置
      • 修改首页课程类型配置状态
      • 不可选课程归属列表(修改时需传入ID)
    • 【运营控制台】HSK书写汉字
      • 查询列表
      • 查看详情
      • 修改汉字
      • 状态变更
    • 【运营控制台】HSK专项课名单管理
      • 查询HSK专项课名单列表
      • HSK专项课名单详细信息
      • 新增HSK专项课名单
      • 修改HSK专项课名单
      • 删除HSK专项课名单
      • 修改名单状态(开/停课)
      • 下载模板
      • 导入数据
      • 导出失败数据
    • 【运营控制台】文章字幕
      • 获取文章字幕
      • 编辑文章字幕
      • 删除文章字幕
      • 下载字幕文件
      • 解析字幕文件
      • 文章字幕状态
    • 【运营控制台】HSK课次
      • 查询课次列表
      • 课次详细信息
      • 新增课次
      • 修改课次
      • 删除课次
      • 修改课次状态
      • 检查是否被绑定 (type: 0-删除 1-编辑)
      • 复制课次
    • 【运营控制台】学习站点
      • 查询学习关卡列表
      • 导出学习关卡列表
      • 学习关卡详细信息
      • 新增学习关卡
      • 修改学习关卡
      • 删除学习关卡
      • 修改学习关卡状态
      • 获取下拉列表
      • 修改免费状态
      • 修改学习关卡状态
      • 获取站点列表
      • 获取站点列表
      • 查询词汇使用的站点id
      • 查询使用词汇的站点课程
    • 【运营控制台】刷题专辑
      • 查询刷题专辑列表
      • 刷题专辑详细信息
      • 新增刷题专辑
      • 修改刷题专辑
      • 删除刷题专辑
      • 修改刷题专辑状态
    • 【运营控制台】首页栏目配置
      • 查询首页栏目列表
      • 首页栏目详细信息
      • 新增首页栏目
      • 修改首页栏目
      • 删除首页栏目
      • 修改首页栏目状态
      • 顺序变更
    • 【运营控制台】反向配置系统课
      • 获取全部数据(只返回ID和名称)
      • 获取子分组数据
      • 添加练习册
      • 添加课次
    • 【运营控制台】学词进度
      • 查询学词进度列表
      • 导出学词进度列表
      • 学词进度详细信息
      • 新增学词进度
      • 修改学词进度
      • 删除学词进度
      • 修改学词进度状态
      • 查询用户未领取宝箱数
    • 【运营控制台】HSK课程
      • 下载用户预习、复习数据
      • 查询课程列表
      • 课程详细信息
      • 新增课程
      • 修改课程
      • 删除课程
      • 修改课程状态
      • 复制课程
      • 获取课程内容
      • 修改课程内容
      • 下载模板
      • 导入数据
      • 上架校验
      • 课次详情预览
      • 学习数据页面信息
      • 学习数据列表
      • 用户学习数据页面信息
      • 用户学习数据
      • 下载用户学习数据
      • 获取系统课词汇模块全部练习册
      • 删除Unit学习数据
      • 隐藏或显示Unit
      • 获取系统课预览凭证
      • 查询单元列表接口
      • 批量根据UnitId查询系统课词汇
      • 查询用户产生学习数据的课程列表
    • 【运营控制台】学词报告
      • 查询学词报告列表
      • 导出学词报告列表
      • 学词报告详细信息
      • 新增学词报告
      • 修改学词报告
      • 删除学词报告
      • 修改学词报告状态
    • 【运营控制台】学词流水
      • 查询学词流水列表
      • 导出学词流水列表
      • 学词流水详细信息
      • 新增学词流水
      • 删除学词流水
      • 修改学词流水状态
    • 【运营控制台】学词章节
      • 查询学词章节列表
        POST
      • 导出学词章节列表
        POST
      • 学词章节详细信息
        GET
      • 新增学词章节
        POST
      • 修改学词章节
        PUT
      • 暂存
        PUT
      • 删除学词章节
        DELETE
      • 修改学词章节状态
        PUT
      • 模糊搜索词
        GET
      • 查询等级下的单元
        GET
      • 初始化释义
        GET
      • 章节内容调整-课次顺序
        POST
    • 【运营控制台】HSK专项课程相关
      • 错题列表
      • 错题用户
      • 根据题目ID构建练习册对象供前端填充表单
      • 生成二维码
    • 【运营控制台】HSK真题
      • 查询真题列表
      • 真题详细信息
      • 练习册详细信息
      • 新增真题
      • 修改真题
      • 删除真题
      • 修改真题状态
      • 修改精听开关状态
      • 生成精听文章
      • 年份/卷号列表
      • 新增年份/卷号
      • 删除年份/卷号
      • 年份/卷号顺序变更
      • 文案列表
    • 【运营控制台】学词流水记录
      • 查询学词流水记录列表
      • 导出学词流水记录列表
      • 学词流水记录详细信息
      • 新增学词流水记录
      • 修改学词流水记录
      • 删除学词流水记录
      • 修改学词流水记录状态
    • 【运营控制台】HSK班级作业相关
      • 根据班级获取作业列表
      • 删除作业
      • 根据作业ID获取作业详情
      • 新增或更新作业信息
      • 校验周是否存在作业
      • 修改推送状态
      • 一键全量推送
    • 【运营控制台】HSK班级
      • 班级列表
      • 班级全部创建人列表
      • 复制班级
      • 自动生成班级ID
      • 新增班级
      • 编辑班级信息
      • 解散班级
      • 班级学员列表
      • 获取班级学员人数
      • 新增班级学员
      • 移除班级学员
      • 班级直播计划列表
      • 新增直播计划
      • 编辑直播计划
      • 删除直播计划
      • 更新直播计划课件信息
      • 获取直播计划课件列表和视频信息
      • 获取学情汇总数据
      • 获取班级课表
      • 更新班级课表
      • 根据班级获取周列表
    • 【APP】反馈
      • 上报反馈
      • 退出原因收集
    • 【APP】学习站点V2
      • 线路图-桃李等级 V3.3.0
      • 查询站点数据V3.3.0
      • 站点-桃李币购买V3.8.0
    • 【APP】学词收藏
      • 查询学词收藏列表V3.0.0
      • 收藏/取消收藏V3.0.0
    • 【APP】首页Tab
      • 首页tab
      • 首页tab V4.3.0
      • 首页tab V4.7.0
      • 课程tab V4.7.0
      • 在学课程tab V4.7.0
      • 练习tab V4.7.0
      • 练习tab V4.8.4
      • 首页tab V4.8.5
      • 课程tab V4.8.5
    • 【APP】学习关卡v1
      • v1 查询所有关卡数据V3.0.0
    • 【APP】HSK专项课程-v2
      • 获取课程首页信息
      • 获取单元列表
      • 根据系统课预览凭证获取课程单元列表
      • 根据cid获取对应数据
    • 【APP】学词报告
      • v2 上报单元学习时长 V3.3.0
      • 查看学习报告V3.0.0
      • 查看学习报告V3.7.0
    • 【APP】单元题信息
      • 查询单元词汇习题V3.0.0
    • 【APP】学词章节
      • 学词单元详细信息V3.0.0
      • 学词单元详细信息(无需登录接口)
      • 生成学习报告V3.0.0
      • v2 生成学习报告V3.2.0
      • 上报学词进度(开启宝箱后)
      • V3.3.0 v2拼合词汇
    • 【APP】首页线路图课程
      • 首页课程介绍
      • 学习报告分享页
      • 相关配置信息
    • 【APP】HSK专项课程
      • 听读训练-上报答题记录
      • 课程详细信息
      • 听读训练-生成报告
      • 听读训练-查看报告
      • 课文内容
      • 根据句子获取口语测评结果
      • 获取单元列表
      • 获取直播录屏信息
      • 课次详情
      • 更新课次进度
      • 词汇列表
      • 学习动作上报
      • 词汇Pass
      • 获取练习习题
      • 获取练习汉字
      • 上报答题记录
      • 生成报告
      • 查看报告
      • 错题本页面
      • 错题记录
      • 错题开始练习
      • 错题答题设置
      • 查看答案
      • 错题上报答题
      • 错题生成报告
      • 错题查看报告
      • 【Web】课程专项练习列表
      • 我的课程列表
      • 扫码临时错题集合二维码
      • 根据系统课预览凭证获取课程单元列表(该凭证用一次即销毁)
      • 扫码系统课词汇
    • 【APP】HSK真题
      • 年度下拉列表
      • 真题列表
      • 真题详情
      • 听力详情
      • 汉字列表
      • 汉字学习上报
      • 题目AI解析试用
      • (收藏/取消收藏)真题题目
      • 我的收藏列表
      • 查询收藏题目详情
      • 练习记录列表
      • 专属练习主页
      • 专属练习列表
    • 【APP】学词流水
      • 更新学词状态
      • 词汇练习
  • member
    • 【运营控制台】用户标签
      • 查询标签列表
      • 导出标签列表
      • 标签详细信息
      • 新增标签
      • 修改标签
      • 用户详情内修改用户标签V2.4.0
      • 删除标签
      • 类型状态
      • 查询全部标签
  • apusic
  • question
    • 【运营后台】题库管理
      • 题库列表
      • 新增题库
      • 修改题库
      • 题库详情
      • 题库解析详情
      • 题库解析修改
      • 题库关联内容详情
      • 题库关联内容新增
      • 题库关联内容编辑
      • 题库新增
      • 题目列表动态表头获取 以及总数
      • 获取文本拼音
      • 查询使用词汇的习题
      • queryQuestionByIds
      • 根据题目查询答题统计
      • 同步答题进度到统计表
      • 修改题目审核状态
      • 题目导入
      • 导出成功文件
      • 导出失败文件
      • 父子题关联查询
      • 题目备注列表
      • 新增题目备注【返回备注ID】
      • 查询题目详情并返回对构建练习册时友好的响应
    • 【APP】等级测评
      • 获取测评试题
      • 获取试题信息
      • 获取测评报告
      • 题目详情
      • 获取题目信息
      • [COCOS] 题目信息批量获取V3.1.0
      • [APP]题目信息批量获取V3.1.0
      • 题目错误反馈
    • 【运营控制台】试卷
      • 查询试卷列表
      • 试卷详细信息
      • 新增试卷
      • 修改试卷
      • 删除试卷
      • 修改试卷状态
      • 查询答卷记录
      • 报告(答卷)详情
      • 导出答卷记录
      • 错题列表
      • 错题用户
    • 【APP】HSK考试
      • 保存hsk学情
      • 学情详情
      • 查询考卷列表
      • 试卷详情
      • 根据HSK等级获取试卷信息
      • 扫码查看试卷详情(包含题目信息)
      • 交卷
      • 报告详情
      • 我的考卷
      • 错题本
      • 老师点评
      • 我的考卷去重列表
      • 开始考试(更新进度)
    • 【APP】中文水平等级测评
      • 测评题目提交/获取
  • exercise
    • 【APP】线路图练习题 V2
      • 查询单元题列表
      • 根据用途取题目
      • 题列表(组合参数)
      • 测试流程更新试题信息
      • 获取口语测评结果
      • 根据词汇获取口语测评结果
    • 【运营控制台】用户测评
      • 查询用户测评列表
  1. 【运营控制台】学词章节

新增学词章节

POST
/roadmap/chapter/add
新增学词章节

请求参数

Header 参数
payload
string 
可选
默认值:
{'mid':{{mid}},'username':{{username}}}
Authorization
string 
可选
默认值:
bearer {{access_token}}
Body 参数application/json
levelId
integer <int64>
关卡ID
可选
gradeId
integer <int64>
等级ID
可选
backImg
string 
背景图片
可选
lang
array[string]
语言
可选
title
string 
标题
可选
>= 1 字符<= 70 字符
tips
string 
简介
可选
coverImg
string 
可选
封面图片-默认取视频图片
words
array[string]
词库词ID
可选
version
enum<string> 
可选
版本 1新版,0旧版
枚举值:
NOYESNE
video
integer <int64>
视频ID
可选
examples
string 
可选
例句: 词库释义ID
duration
string 
视频时长
可选
status
enum<string> 
可选
1 可用, 0 不可用
枚举值:
FAILEDBLOCKENABLESHELVESUNBLOCKDISABLE
remark
string 
备注
可选
studyWords
array[object (ChapterWordDTO) {25}] 
v2 内容
可选
id
integer <int64>
id
可选
wordId
integer <int64>
词id
必需
chTitle
string 
视频名称
可选
introduce
integer <int64>
视频介绍URI
可选
introduces
array[object (OptionsVO) {9}] 
视频介绍下拉
可选
explainedType
enum<string> 
可选
讲解类型 0 视频,1 图文
枚举值:
NOYESNE
explained
integer <int64>
讲解视频URI
可选
grammarImage
string 
语法图片
可选
grammarContent
string 
语法文本
可选
explains
array[object (OptionsVO) {9}] 
讲解视频下拉框
可选
partTypes
array[object (OptionsVO) {9}] 
词性下拉框
可选
remark
string 
图文URI
可选
lang
string 
语言
可选
status
enum<string> 
可选
1 可用, 0 不可用
枚举值:
FAILEDBLOCKENABLESHELVESUNBLOCKDISABLE
wsort
integer 
排序
可选
partType
integer <int64>
可选
词性ID, 对应词库释义ID
splitWord
array[object (WordItemDTO) {6}] 
拆词
可选
types
array[string]
可选
拆词规则组[1,2]
mode
enum<string> 
可选
是否随机 0 否, 1是
枚举值:
NOYESNE
type
enum<string> 
可选
拆解规则,关联规则id - 拆解类型 0 不拆, 1 生母韵母, 2 按字拆
枚举值:
DEFARTWORD
wordVo
array[object (OptionsVO) {9}] 
词组
可选
category
enum<string> 
词条类型
可选
枚举值:
NOWORDSENTENCE
writeSwitch
enum<string> 
可选
书写开关 1-开 0-关
枚举值:
NOYESNE
followSwitch
enum<string> 
可选
跟读开关 1-开 0-关
枚举值:
NOYESNE
assemble
array[object (MapListString) {1}] 
可选
选项和答案,多模式拆分规则
示例
{
    "levelId": 0,
    "gradeId": 0,
    "backImg": "string",
    "lang": [
        "string"
    ],
    "title": "string",
    "tips": "string",
    "coverImg": "string",
    "words": [
        "string"
    ],
    "version": "NO",
    "video": 0,
    "examples": "string",
    "duration": "string",
    "status": "FAILED",
    "remark": "string",
    "studyWords": [
        {
            "id": 0,
            "wordId": 0,
            "chTitle": "string",
            "introduce": 0,
            "introduces": [
                {
                    "dictValue": "string",
                    "dictLabel": "string",
                    "listClass": "default",
                    "tonePinyin": "string",
                    "numberPinyin": "string",
                    "other": "string",
                    "params": "string",
                    "category": "NO",
                    "type": 0
                }
            ],
            "explainedType": "NO",
            "explained": 0,
            "grammarImage": "string",
            "grammarContent": "string",
            "explains": [
                {
                    "dictValue": "string",
                    "dictLabel": "string",
                    "listClass": "default",
                    "tonePinyin": "string",
                    "numberPinyin": "string",
                    "other": "string",
                    "params": "string",
                    "category": "NO",
                    "type": 0
                }
            ],
            "partTypes": [
                {
                    "dictValue": "string",
                    "dictLabel": "string",
                    "listClass": "default",
                    "tonePinyin": "string",
                    "numberPinyin": "string",
                    "other": "string",
                    "params": "string",
                    "category": "NO",
                    "type": 0
                }
            ],
            "remark": "string",
            "lang": "string",
            "status": "FAILED",
            "wsort": 0,
            "partType": 0,
            "splitWord": [
                {
                    "type": "DEF",
                    "word": "string",
                    "spell": "string",
                    "audio": "string",
                    "sort": 0,
                    "splices": [
                        {}
                    ]
                }
            ],
            "types": [
                "string"
            ],
            "mode": "NO",
            "type": "DEF",
            "wordVo": [
                {
                    "dictValue": "string",
                    "dictLabel": "string",
                    "listClass": "default",
                    "tonePinyin": "string",
                    "numberPinyin": "string",
                    "other": "string",
                    "params": "string",
                    "category": "NO",
                    "type": 0
                }
            ],
            "category": "NO",
            "writeSwitch": "NO",
            "followSwitch": "NO",
            "assemble": [
                {
                    "key": [
                        "string"
                    ]
                }
            ]
        }
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://test-apisix.taolihanyu.net/roadmap/chapter/add' \
--header 'payload: {'\''mid'\'':{{mid}},'\''username'\'':{{username}}}' \
--header 'Authorization: bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "levelId": 0,
    "gradeId": 0,
    "backImg": "string",
    "lang": [
        "string"
    ],
    "title": "string",
    "tips": "string",
    "coverImg": "string",
    "words": [
        "string"
    ],
    "version": "NO",
    "video": 0,
    "examples": "string",
    "duration": "string",
    "status": "FAILED",
    "remark": "string",
    "studyWords": [
        {
            "id": 0,
            "wordId": 0,
            "chTitle": "string",
            "introduce": 0,
            "introduces": [
                {
                    "dictValue": "string",
                    "dictLabel": "string",
                    "listClass": "default",
                    "tonePinyin": "string",
                    "numberPinyin": "string",
                    "other": "string",
                    "params": "string",
                    "category": "NO",
                    "type": 0
                }
            ],
            "explainedType": "NO",
            "explained": 0,
            "grammarImage": "string",
            "grammarContent": "string",
            "explains": [
                {
                    "dictValue": "string",
                    "dictLabel": "string",
                    "listClass": "default",
                    "tonePinyin": "string",
                    "numberPinyin": "string",
                    "other": "string",
                    "params": "string",
                    "category": "NO",
                    "type": 0
                }
            ],
            "partTypes": [
                {
                    "dictValue": "string",
                    "dictLabel": "string",
                    "listClass": "default",
                    "tonePinyin": "string",
                    "numberPinyin": "string",
                    "other": "string",
                    "params": "string",
                    "category": "NO",
                    "type": 0
                }
            ],
            "remark": "string",
            "lang": "string",
            "status": "FAILED",
            "wsort": 0,
            "partType": 0,
            "splitWord": [
                {
                    "type": "DEF",
                    "word": "string",
                    "spell": "string",
                    "audio": "string",
                    "sort": 0,
                    "splices": [
                        {}
                    ]
                }
            ],
            "types": [
                "string"
            ],
            "mode": "NO",
            "type": "DEF",
            "wordVo": [
                {
                    "dictValue": "string",
                    "dictLabel": "string",
                    "listClass": "default",
                    "tonePinyin": "string",
                    "numberPinyin": "string",
                    "other": "string",
                    "params": "string",
                    "category": "NO",
                    "type": 0
                }
            ],
            "category": "NO",
            "writeSwitch": "NO",
            "followSwitch": "NO",
            "assemble": [
                {
                    "key": [
                        "string"
                    ]
                }
            ]
        }
    ]
}'

返回响应

🟢200成功
application/json
Body
code
string 
可选
data
integer 
可选
msg
string 
可选
total
integer 
可选
示例
{
  "code": "",
  "data": 0,
  "msg": "",
  "total": 0
}
修改于 2025-06-20 03:31:02
上一页
学词章节详细信息
下一页
修改学词章节
Built with