云存储微服务接口

接口目录

• 上传文件
• 下载URL上的文件到云存储
• 获取文件列表
• 获取文件信息
• 删除文件信息
• 初始化分片任务
• 上传分片文件
• 完成分片上传
• 取消分片上传
• 获取分片上传任务

上传文件

POST /storage/api/upload

该接口为同步接口，上传完成后能马上得到文件 URL

表单参数

返回字段

返回示例：

{
    "errcode": 1000,
    "msg": "OK",
    "id": "a4b9dnoj",
    "url": "http://example.mudu.tv/a4b9dnoj-example.txt"
}

下载URL上的文件到云存储

POST /storage/api/download_url

该接口为异步接口，调用后马上返回，需要通过查询文件状态来确认是否上传完成

JSON 参数

返回字段

返回示例：

{
    "errcode": 1000,
    "msg": "OK",
    "id": "a4b9dnoj"
}

获取文件列表

GET /storage/api/list

URL 参数

返回字段

文件状态表：

返回示例：

{
    "errcode": 1000,
    "msg": "OK",
    "count": 234,
    "files": [{
        "id": "dok80b1y",
        "status": 1,
        "source_type": "url",
        "public_url": "http://example.mudu.tv/a4b9dnoj-example.mp4",
        "file_name": "example.mp4",
        "file_size": 68520395
    }]
}

获取文件信息

GET /storage/api/get

URL 参数

返回字段

文件状态表：

返回示例：

{
    "errcode": 1000,
    "msg": "OK",
    "file": {
        "id": "dok80b1y",
        "status": 1,
        "source_type": "url",
        "public_url": "http://example.mudu.tv/a4b9dnoj-example.mp4",
        "file_name": "example.mp4",
        "file_size": 68520395
    }
}

删除文件信息

POST /storage/api/delete

URL 参数

返回字段

返回示例：

{
    "errcode": 1000,
    "msg": "OK"
}

初始化分片任务

POST /storage/api/init_upload_part

注意：获取到的 upload_id 用于后面 /upload_part, /complete_upload_part 和 /abort_upload_part 的 id 字段

JSON 参数

返回字段

返回示例：

{
    "errcode": 1000,
    "msg": "OK",
    "upload_id": "mok80b1y"
}

上传分片文件

POST /storage/api/upload_part

URL 参数

表单参数：

返回字段

返回示例：

{
    "errcode": 1000,
    "msg": "OK"
}

完成分片上传

POST /storage/api/complete_upload_part

URL 参数

JSON 参数：

返回字段

返回示例：

{
    "errcode": 1000,
    "msg": "OK",
    "id": "dvoneo63"
}

取消分片上传

POST /storage/api/abort_upload_part

URL 参数

返回字段

返回示例：

{
    "errcode": 1000,
    "msg": "OK"
}

获取分片上传任务

GET /storage/api/get_upload_part_task

URL 参数

返回字段

分片任务状态表：

返回示例：

{
    "errcode": 1000,
    "msg": "OK",
    "task": {
        "upload_id": "mok80b1y",
        "status": 0,
        "uploaded_parts": [1, 2, 4, 5, 7],
        "file_name": "example.mp4"
    }
}

错误码