辅助工具API(测试版)

3.广告视频转换 – 通用场景(包括破框视频mov->mp4转换和TV投屏视频转换)

提交接口:assisttool/convertvideo
请求字段:

名称类型描述
data数组类型最多1个

data内容详细:

名称类型必填描述
display_idintY播放形式ID
urlstringY视频创意url

注:display_id必填其中涉及投屏资源时,display_id填写200140,获取转换后含有广告标的视频素材

接口返回:

名称类型描述
ret_codeint返回码
ret_msg数组类型返回内容
error_codeint错误补充码

ret_msg内容详细:

名称类型描述
urlstring视频创意原始url
idint转换id
error_codeint需要时返回,成功时不返回,失败返回具体错误码
err_msgstring需要时返回,成功时不返回,错误具体描述

请求示例:

{
    "data": [
        {
            "url": "http://dsptest.adx.qq.com/upload/ryt.mov"
        }
    ],
 "dsp_id": 111,
 "sig": "111",
 ...
}

返回示例:

{
    "ret_code": 0,
    "ret_msg": [
        {
            "url": "http://dsptest.adx.qq.com/images/ryt2.mov",
            "id": 100001
        }
    ],
    "error_code": 0
}

获取结果接口:assisttool/convertvideoresult 
请求字段:

名称类型描述
data数组类型最多1个

data内容详细:

名称类型必填描述
idintY转换id

接口返回:

名称类型描述
ret_codeint返回码
ret_msg数组类型返回内容
error_codeint错误补充码

ret_msg内容详细:

名称类型描述
urlstring视频创意原始url
convert_urlstring视频创意转换后url
idint转换id
error_codeint需要时返回,成功时不返回,失败返回具体错误码
err_msgstring需要时返回,成功时不返回,错误具体描述

请求示例:

{
    "data": [
        {
            "id": 100001
        }
    ],
 "dsp_id": 111,
 "sig": "111",
 ...
}

返回示例:

{
    "ret_code": 0,
    "ret_msg": [
        {
            "id": 100001,
            "url": "http://dsptest.adx.qq.com/upload/ryt.mov",
            "convert_url": "https://dsptest.adx.qq.com/filefascade/getconvertfile?id=MTAwMjQyNGI1NzE3YmFmZmI4NDQwZDYzNWNjYTJhNDhjZjEzZGM=&tp=2"
        }
    ],
    "error_code": 0
}