API参考

• HTTP 接口
  • 创建云剪辑
  • 获取一页云剪辑
  • 分享云剪辑
  • 删除云剪辑
  • 获取一个云剪辑
  • 更新云剪辑

HTTP 接口

创建云剪辑

POST /media_editor/api/create_editor

JSON 参数

返回字段

返回示例：

{
    "editor_id": "17lok52y",
    "errcode": 1000,
    "msg": "OK"
}

注：当media_api_url_type值为'iframe'时，云剪辑页面会弹出一个页面让用户选择视频资源，这个页面地址是media_api_url；当media_api_url_type为其他值或者为空时，云剪辑会通过api请求的方式请求'media_api_url'地址，然后展示给用户来选择视频；

media_api_url 作为接口地址的规范

假设 media_api_url 为 http://yourserver.com/choose_video

云剪辑进行GET分页请求 http://yourserver.com/choose_video?page=1&page_size=10，其中page为每次分页的页码, page_size为每页视频数量，现在的值是10；服务器需要返回一个json，格式如下， 其中count为视频总数量，videos为当前页码的视频列表，thumb_url为视频封面，video_name为视频名称, video_duration为视频时长(单位为毫秒)，video_url为视频地址。

{
    "count": 23,
    "videos": [
        {
            "video_name": "视频名称",
            "video_url": "https://myun-hw-s3.myun.tv/d5vjn158/5z8426v5/livebroadcast/e54dxnk5-1557195190-t.flv",
            "thumb_url": "https://myun-hw-s3.myun.tv/d5vjn158/5peovgbl/1557196305805672054.jpg",
            "video_duration": 1105065
        }
    ]
}

media_api_url 作为iframe页面地址的规范

云剪辑打开iframe页面时，会以宽932px，高579px的大小打开，所以iframe页面应该尽可能的适配这个尺寸。 当用户选择完视频后，iframe页面需要进行postMessage将选择后的视频列表信息传给云剪辑页面，然后关闭当前iframe页面，例子如下：

// 用户选择完成后

// selectVideos为用户选择的视频列表
var selectVideos = [
    {
        "video_name": "视频名称",
        "video_url": "https://myun-hw-s3.myun.tv/d5vjn158/5z8426v5/livebroadcast/e54dxnk5-1557195190-t.flv",
        "thumb_url": "https://myun-hw-s3.myun.tv/d5vjn158/5peovgbl/1557196305805672054.jpg",
        "video_duration": 1105065
    }
]
window.opener.postMessage(selectVideos, '*')
window.close()

获取一页云剪辑

GET /media_editor/api/list_editors

URL 参数

返回字段

注意：画布宽高只支持720P

返回示例：

{
    "count": 33,
    "editors": [
        {
            "editor_id": "17lok52y",
            "created_at": "2010-11-22 15:16:17",
            "updated_at": "2010-11-22 15:16:17",
            "title": "1",
            "canvas_width": 1280,
            "canvas_height": 720,
            "media_api_url": "1",
            "m3u8_url": "1",
            "duration": 1
        }
    ],
    "errcode": 1000,
    "msg": "OK"
}

分享云剪辑

POST /media_editor/api/share_editor

URL 参数

JSON 参数

返回字段

返回示例：

{
    "errcode": 1000,
    "msg": "OK",
    "shared_key": "xxx",
    "shared_url": ""
}

删除云剪辑

POST /media_editor/api/delete_editor

URL 参数

返回字段

返回示例：

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

获取一个云剪辑

GET /media_editor/api/get_editor

URL 参数

返回字段

返回示例：

{
    "editor": {
        "editor_id": "17lok52y",
        "created_at": "2010-11-22 15:16:17",
        "updated_at": "2010-11-22 15:16:17",
        "title": "1",
        "canvas_width": 1,
        "canvas_height": 1,
        "media_api_url": "1",
        "m3u8_url": "1",
        "duration": 1,
        "json_config": "1"
    },
    "errcode": 1000,
    "msg": "OK"
}

更新云剪辑

POST /media_editor/api/update_editor

URL 参数

JSON 参数

返回字段

返回示例：

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