Base URLs:
鉴权与返回约定(请先阅读)
Header 鉴权参数
X-ACCESSID:用户 AK 的 accessIdX-TIMESTAMP:当前时间戳(秒)X-SIGNATURENONCE:签名随机串(建议每次请求使用新的随机值,避免重放)X-SIGNATURE:签名值
X-SIGNATURE 计算规则
将以下字段按顺序拼接,中间以换行符 \n 连接:
accessId(即X-ACCESSID)accessKey(用户 AK 的 accessSecret)signatureNonce(即X-SIGNATURENONCE)timeStamp(即X-TIMESTAMP)body(HTTP 请求原始 Body 字符串;无 Body 时为空字符串)
拼接字符串示例:
stringToSign = accessId + "\n" + accessKey + "\n" + signatureNonce + "\n" + timeStamp + "\n" + body
最终签名:
X-SIGNATURE = md5(stringToSign)
返回码约定
flag = 100:请求成功flag != 100:请求失败,具体原因见flagString
请求格式约定
- 所有接口统一使用
application/json作为请求体格式。 - 请在请求 Header 中设置
Content-Type: application/json。
POST 上传文件分片
POST /mls/mlsOpenApi/uploadMlsPart
Body 请求参数
{
"fileName": "test.mp4",
"part": "base64_encode('xxxxxxx')",
"partNum": 1
}
请求参数
| 名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| fileName | string | 是 | 完整文件名(含后缀) |
| part | string | 是 | 分片内容需要将做一次base64_encode;分片小于10M |
| partNum | int | 是 | 分片序号,取值范围 1~1000 |
返回示例
200 Response
{
"flag": 100,
"flagString": "success",
"data": {
"partSize": 2097152,
"partName": "1-test.mp4.part"
}
}
POST 完成分片上传
POST /mls/mlsOpenApi/completeMlsUpload
Body 请求参数
{
"fileName": "test.mp4"
}
请求参数
| 名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| fileName | string | 是 | 与分片上传阶段保持一致的文件名(含后缀) |
返回示例
200 Response
{
"flag": 100,
"flagString": "success",
"data": {
"fileName": "test.mp4",
"size": 38112078,
"location": "http://1089.long-vod.cdn.jstest.aodianyun.cn/u/1089/mp4/0x0/9c259c15483898854dad9938736a6c78.mp4", //视频地址
"thumbnail": "http://cdn-dvr.jstest.aodianyun.cn/pic/g-dvr/u/1089/images/9c259c15483898854dad9938736a6c78/0/0" // 封面图
}
}
POST 获取用户可用的语种
POST /mls/mlsOpenApi/getSupportLanguageList
请求参数
返回示例
200 Response
{
"flag": 100,
"flagString": "success",
"data": {
"list": [
{
"id": 1,
"language_name": "中文",
"language_code": "chinese",
"enable": 1,
"create_time": 1770444003,
"uptime": 1770444003
},
{
"id": 2,
"language_name": "英文",
"language_code": "english",
"enable": 1,
"create_time": 1770444003,
"uptime": 1770444003
}
]
}
}
POST 获取任务列表
POST /mls/mlsOpenApi/getUserMlsList
Body 请求参数
{
"page": 1,
"num": 15,
"resStatus": -1,
"title": "1",
"episodeId": ""
}
请求参数
| 名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| page | int | 否 | 页码,默认从 1 开始 |
| num | int | 否 | 每页数量 |
| resStatus | int | 否 | 状态筛选,-1 表示全部 0待处理,1处理中,2部分完成,3全部完成,4全部失败 |
| title | string | 否 | 按项目标题模糊筛选 |
| episodeId | int | 否 | 按 ID 精确筛选 |
返回示例
200 Response
{
"flag": 100,
"flagString": "success",
"data": [
{
"episodeId": 26,
"dramaId": 14,
"uin": 1089,
"parentId": "01",
"userId": 1089,
"title": "工程1",
"duration": 32,
"origin_url": "https://mls-long.jstest.aodianyun.cn/u/1089/mp4/0x0/mls-108929d58182668ebbe0aa7bdb1030f10953.mp4",
"languages": "italian",
"resStatus": 0,
"results": "[{\"language\":\"italian\",\"status\":0,\"uptime\":1776133477,\"url\":\"\"}]",
"is_pay": 0,
"is_del": 0,
"create_time": 1776133477,
"uptime": 1776133477
}
],
"total": 3
}
POST 创建任务
POST /mls/mlsOpenApi/addMlsTask
Body 请求参数
{
"title": "工程1",
"origin_url": "http://1089.long-vod.cdn.jstest.aodianyun.cn/u/1089/mp4/0x0/mls-108929d58182668ebbe0aa7bdb1030f10953.mp4",
"languages": "italian"
}
请求参数
| 名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| title | string | 是 | 标题 |
| origin_url | string | 是 | 源视频地址(可访问的媒体 URL) |
| languages | string | 是 | 目标语种编码(如:italian), 多个以逗号隔开 |
返回示例
200 Response
{
"flag": 100,
"flagString": "success"
}
POST 编辑任务
POST /mls/mlsOpenApi/updateMlsTask
Body 请求参数
{
"episodeId": 26,
"title": "222",
"languages": "indonesian"
}
请求参数
| 名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| episodeId | int | 是 | ID |
| title | string | 否 | 新的任务标题 |
| languages | string | 否 | 新的目标语种编码(如:indonesian), 多个以逗号隔开 |
返回示例
200 Response
{
"flag": 100,
"flagString": "success"
}
POST 删除任务
POST /mls/mlsOpenApi/deleteMlsTask
Body 请求参数
{
"episodeId": 27
}
请求参数
| 名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| episodeId | int | 是 | ID |
返回示例
200 Response
{
"flag": 100,
"flagString": "success"
}最后编辑: 广电云技术部 文档更新时间: 2026-04-14 17:47 作者:广电云技术部