桃李中文-Taoli-Cloud
  1. 【运营控制台】专项课文章
桃李中文-Taoli-Cloud
  • roadmap
    • 【运营控制台】专项课文章
      • 查询文章列表
        POST
      • 文章详细信息
        GET
      • 新增文章
        POST
      • 修改文章
        PUT
      • 删除文章
        DELETE
      • 修改文章状态
        PUT
      • 操作检测
        GET
      • 查词标记
        POST
    • 【运营控制台】HSK课程直播录播相关
      • 添加或保存直播计划
      • 删除直播计划
    • 【运营控制台】首页课程类型配置
      • 查询首页课程类型配置列表
      • 首页课程类型配置详细信息
      • 新增首页课程类型配置
      • 修改首页课程类型配置
      • 删除首页课程类型配置
      • 修改首页课程类型配置状态
      • 不可选课程归属列表(修改时需传入ID)
    • 【运营控制台】HSK书写汉字
      • 查询列表
      • 查看详情
      • 修改汉字
      • 状态变更
    • 【运营控制台】HSK专项课名单管理
      • 查询HSK专项课名单列表
      • HSK专项课名单详细信息
      • 新增HSK专项课名单
      • 修改HSK专项课名单
      • 删除HSK专项课名单
      • 修改名单状态(开/停课)
      • 下载模板
      • 导入数据
      • 导出失败数据
    • 【运营控制台】文章字幕
      • 获取文章字幕
      • 编辑文章字幕
      • 删除文章字幕
      • 下载字幕文件
      • 解析字幕文件
      • 文章字幕状态
    • 【运营控制台】HSK课次
      • 查询课次列表
      • 课次详细信息
      • 新增课次
      • 修改课次
      • 删除课次
      • 修改课次状态
      • 检查是否被绑定 (type: 0-删除 1-编辑)
      • 复制课次
    • 【运营控制台】学习站点
      • 查询学习关卡列表
      • 导出学习关卡列表
      • 学习关卡详细信息
      • 新增学习关卡
      • 修改学习关卡
      • 删除学习关卡
      • 修改学习关卡状态
      • 获取下拉列表
      • 修改免费状态
      • 修改学习关卡状态
      • 获取站点列表
      • 获取站点列表
      • 查询词汇使用的站点id
      • 查询使用词汇的站点课程
    • 【运营控制台】刷题专辑
      • 查询刷题专辑列表
      • 刷题专辑详细信息
      • 新增刷题专辑
      • 修改刷题专辑
      • 删除刷题专辑
      • 修改刷题专辑状态
    • 【运营控制台】首页栏目配置
      • 查询首页栏目列表
      • 首页栏目详细信息
      • 新增首页栏目
      • 修改首页栏目
      • 删除首页栏目
      • 修改首页栏目状态
      • 顺序变更
    • 【运营控制台】反向配置系统课
      • 获取全部数据(只返回ID和名称)
      • 获取子分组数据
      • 添加练习册
      • 添加课次
    • 【运营控制台】学词进度
      • 查询学词进度列表
      • 导出学词进度列表
      • 学词进度详细信息
      • 新增学词进度
      • 修改学词进度
      • 删除学词进度
      • 修改学词进度状态
      • 查询用户未领取宝箱数
    • 【运营控制台】HSK课程
      • 下载用户预习、复习数据
      • 查询课程列表
      • 课程详细信息
      • 新增课程
      • 修改课程
      • 删除课程
      • 修改课程状态
      • 复制课程
      • 获取课程内容
      • 修改课程内容
      • 下载模板
      • 导入数据
      • 上架校验
      • 课次详情预览
      • 学习数据页面信息
      • 学习数据列表
      • 用户学习数据页面信息
      • 用户学习数据
      • 下载用户学习数据
      • 获取系统课词汇模块全部练习册
      • 删除Unit学习数据
      • 隐藏或显示Unit
      • 获取系统课预览凭证
      • 查询单元列表接口
      • 批量根据UnitId查询系统课词汇
      • 查询用户产生学习数据的课程列表
    • 【运营控制台】学词报告
      • 查询学词报告列表
      • 导出学词报告列表
      • 学词报告详细信息
      • 新增学词报告
      • 修改学词报告
      • 删除学词报告
      • 修改学词报告状态
    • 【运营控制台】学词流水
      • 查询学词流水列表
      • 导出学词流水列表
      • 学词流水详细信息
      • 新增学词流水
      • 删除学词流水
      • 修改学词流水状态
    • 【运营控制台】学词章节
      • 查询学词章节列表
      • 导出学词章节列表
      • 学词章节详细信息
      • 新增学词章节
      • 修改学词章节
      • 暂存
      • 删除学词章节
      • 修改学词章节状态
      • 模糊搜索词
      • 查询等级下的单元
      • 初始化释义
      • 章节内容调整-课次顺序
    • 【运营控制台】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. 【运营控制台】专项课文章

修改文章

PUT
/roadmap/article/edit
修改文章

请求参数

Header 参数
payload
string 
可选
默认值:
{'mid':{{mid}},'username':{{username}}}
Authorization
string 
可选
默认值:
bearer {{access_token}}
Body 参数application/json
remark
string 
备注
可选
createBy
string 
创建人
可选
createTime
string 
可选
updateBy
string 
更新人
可选
updateTime
string 
可选
id
integer <int64>
可选
hskLevel
string 
可选
HSK等级
HSK等级 1-6
openPinyin
integer 
开启拼音 0否1是
可选
默认值:
0
mode
integer 
可选
模式 1文章模式 2对话模式
默认值:
1
dialogNum
integer 
对话人数
可选
dialogDisplay
string 
可选
对话显示["A","B"]
audioUrl
string 
音频url
可选
srtUrl
string 
字幕url
可选
duration
integer 
音频时长/ms
可选
questionId
integer <int64>
题目ID
可选
status
integer 
状态
可选
deleted
integer 
可选
是否删除,1删除,0未删除
lang
string 
可选
------------------------ 非数据库字段 ------------------------ //
语言
langList
array[string]
语言列表
可选
title
string 
标题
可选
pinyin
string 
拼音
可选
picture
string 
背景图片
可选
subtitleType
integer 
可选
字幕类型 0-无字幕 1-单字幕 2-双字幕 3-三字幕
默认值:
1
subtitleStatus
integer 
可选
字幕状态 0_未校对,1_已校对
默认值:
0
subtitleList
array[object (ArticleSubtitle) {19}] 
字幕列表
可选
remark
string 
备注
可选
createBy
string 
创建人
可选
createTime
string 
可选
updateBy
string 
更新人
可选
updateTime
string 
可选
id
integer <int64>
ID
可选
articleId
integer <int64>
文章ID
可选
lang
string 
语言版本
可选
version
integer 
字幕版本号
可选
pinyin
string 
中文拼音
可选
content
string 
内容
可选
translation
string 
译文内容
可选
speaker
string 
说话人
可选
speakerAvatar
string 
说话人头像
可选
startTime
string 
开始时间
可选
endTime
string 
结束时间
可选
sort
integer 
序号
可选
deleted
integer 
可选
是否删除 1删除,0未删除
status
integer 
可选
字幕状态 0_未校对,1_已校对
needRegenerate
boolean 
可选
是否需要重新生成 true-是 false-否
默认值:
false
示例
{
    "remark": "string",
    "createBy": "string",
    "createTime": "string",
    "updateBy": "string",
    "updateTime": "string",
    "id": 0,
    "hskLevel": "string",
    "openPinyin": 0,
    "mode": 1,
    "dialogNum": 0,
    "dialogDisplay": "string",
    "audioUrl": "string",
    "srtUrl": "string",
    "duration": 0,
    "questionId": 0,
    "status": 0,
    "deleted": 0,
    "lang": "string",
    "langList": [
        "string"
    ],
    "title": "string",
    "pinyin": "string",
    "picture": "string",
    "subtitleType": 1,
    "subtitleStatus": 0,
    "subtitleList": [
        {
            "remark": "string",
            "createBy": "string",
            "createTime": "string",
            "updateBy": "string",
            "updateTime": "string",
            "id": 0,
            "articleId": 0,
            "lang": "string",
            "version": 0,
            "pinyin": "string",
            "content": "string",
            "translation": "string",
            "speaker": "string",
            "speakerAvatar": "string",
            "startTime": "string",
            "endTime": "string",
            "sort": 0,
            "deleted": 0,
            "status": 0
        }
    ],
    "needRegenerate": false
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT 'http://test-apisix.taolihanyu.net/roadmap/article/edit' \
--header 'payload: {'\''mid'\'':{{mid}},'\''username'\'':{{username}}}' \
--header 'Authorization: bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "remark": "string",
    "createBy": "string",
    "createTime": "string",
    "updateBy": "string",
    "updateTime": "string",
    "id": 0,
    "hskLevel": "string",
    "openPinyin": 0,
    "mode": 1,
    "dialogNum": 0,
    "dialogDisplay": "string",
    "audioUrl": "string",
    "srtUrl": "string",
    "duration": 0,
    "questionId": 0,
    "status": 0,
    "deleted": 0,
    "lang": "string",
    "langList": [
        "string"
    ],
    "title": "string",
    "pinyin": "string",
    "picture": "string",
    "subtitleType": 1,
    "subtitleStatus": 0,
    "subtitleList": [
        {
            "remark": "string",
            "createBy": "string",
            "createTime": "string",
            "updateBy": "string",
            "updateTime": "string",
            "id": 0,
            "articleId": 0,
            "lang": "string",
            "version": 0,
            "pinyin": "string",
            "content": "string",
            "translation": "string",
            "speaker": "string",
            "speakerAvatar": "string",
            "startTime": "string",
            "endTime": "string",
            "sort": 0,
            "deleted": 0,
            "status": 0
        }
    ],
    "needRegenerate": false
}'

返回响应

🟢200成功
application/json
Body
code
string 
可选
data
boolean 
可选
msg
string 
可选
total
integer 
可选
示例
{
  "code": "",
  "data": false,
  "msg": "",
  "total": 0
}
修改于 2025-07-16 08:32:54
上一页
新增文章
下一页
删除文章
Built with