修改文章

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

可选

integer <int64>

可选

hskLevel

string

可选

HSK等级
HSK等级 1-6

openPinyin

integer

开启拼音 0否1是

可选

默认值:

mode

integer

可选

模式 1文章模式 2对话模式

默认值:

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-三字幕

默认值:

subtitleStatus

integer

可选

字幕状态 0_未校对，1_已校对

默认值:

subtitleList

array[object (ArticleSubtitle) {19}]

字幕列表

可选

remark

string

备注

可选

createBy

string

创建人

可选

createTime

string

可选

updateBy

string

更新人

可选

updateTime

string

可选

integer <int64>

可选

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

新增文章

删除文章