腾讯内容开放平台接口文档

服务说明

腾讯内容开放平台为媒体提供开发接入腾讯内容开放平台的解决方案。媒体可使用我们提供的接口服务，将内容接入腾讯内容开放平台。

授权流程说明

用户可以通过对应的腾讯内容开放平台应用，使用唯一的client_id和client_secret换取access_token，然后访问绑定的该 腾讯内容开放平台用户资料，进行发文等操作；

腾讯内容开放平台应用API调用所需的access_token的使用及生成方式说明：

1.为了保密client_secret，需要一个access_token获取和刷新的中控服务器。而其他业务逻辑服务器所使用的access_token均来自于该中控服务器，不应该各自去刷新，否则会造成access_token覆盖而影响业务。

2.目前access_token的有效期通过返回的expire_in来传达，目前是7200秒之内的值。中控服务器需要根据这个有效时间提前去刷新access_token。

获得腾讯内容开放平台应用授权access_token相关API

可以使用client_id和client_secret调用本接口来获取access_token。client_id和client_secret可在腾讯内容开放平台-内容同步-API中获得（需要已开通API服务）。

• http请求方式： POST（请使用https协议）https://auth.om.qq.com/omoauth2/accesstoken

• POST数据格式: JSON

• 调用示例：

lURI: POST https://auth.om.qq.com/omoauth2/accesstoken?grant_type=clientcredentials&client_id=CLIENT_ID&client_secret=CLIENT_SECRET

• 参数列表

·  返回数据

     { "code":"0", "msg": "success", "data": { "access_token":"ACCESS_TOKEN", "expires_in":7200, "refresh_toekn":"REFRESH_TOKEN", "openid":OPENID, "scope":"SCOPE", } } 

·  返回码说明

API接口

一、发表图文

• http请求方式： POST（请使用https协议） https://api.om.qq.com/articlev2/clientpubpic?access_token=ACCESS_TOKEN

• POST数据格式: JSON

• 调用示例：

    curl -H 'Content-Type: application/json' "https://api.om.qq.com/articlev2/clientpubpic?access_token=ACCESS_TOKEN" -d '{"content": CONTENT, "title": TITLE, "cover_pic": COVER_PIC}'

• 参数列表

原创首发平台original_platform取值，如下：

文章分类编号，如下：

• 返回数据

    {

      "code":"0",

      "msg": "success",

      "data": {

        "transaction_id":TRANSACTION_ID,

             "article_id":article_id //腾讯内容开放平台内容唯一id

      }

    }

二、发表组图文章

• http请求方式： POST（请使用https协议） https://api.om.qq.com/articlev2/clientpubgrpic?access_token=ACCESS_TOKEN

• POST数据格式: JSON

• 调用示例：

    curl -H 'Content-Type: application/json' "https://api.om.qq.com/articlev2/clientpubgrpic?access_token=ACCESS_TOKEN" -d '{"content": CONTENT, "title": TITLE, "cover_pic": COVER_PIC}'

• 参数列表

原创首发平台original_platform取值，如下：

文章分类编号，如下：

• 返回数据

    {

      "code":"0",

      "msg": "success",

      "data": {

        "transaction_id":TRANSACTION_ID,

             "article_id":article_id //腾讯内容开放平台内容唯一id  

      }

    }

三、发表视频

• http请求方式： POST（请使用https协议） https://api.om.qq.com/articlev2/clientpubvid?access_token=ACCESS_TOKEN

• POST数据格式: FORM

• 调用示例（使用curl命令，用FORM表单方式上传一个多媒体文件）

    curl -F "media=@test.wmv" "https://api.om.qq.com/articlev2/clientpubvid?access_token=ACCESS_TOKEN&title=TITLE&tags=TAGS&cat=CAT&md5=MD5&desc=DESC"

• 参数列表

• 返回数据

    {

      "code":"0",

      "msg": "success",

      "data": {

        "transaction_id":TRANSACTION_ID,

             "article_id":article_id //腾讯内容开放平台内容唯一id

      }

    }

• 注意事项

    上传的视频文件有格式和大小限制，如下：

    大小：300KB ～ 1GB,视频文件最大1GB

    格式：

•  常见在线流媒体格式：mp4、flv、f4v、webm

• 移动设备格式：m4v、mov、3gp、3g2

•  RealPlayer ：rm、rmvb

•  微软格式 ：wmv、avi、asf

•  MPEG 视频 ：mpg、mpeg、mpe、ts

•  DV格式 ：div、dv、divx

•  其他格式 ：vob、dat、mkv、swf、lavf、cpk、dirac、ram、qt、fli、flc、mod

•  主流音频格式：mp3、aac、ac3、wav、m4a、ogg

• 上传cat视频分类

四、上传视频封面

·  http请求方式： POST（请使用https协议） https://api.om.qq.com/video/clientvideopic?access_token=ACCESS_TOKEN

·  POST数据格式: FORM

·  调用示例（使用curl命令，用FORM表单方式上传一个多媒体文件）

    curl -F “media=@test.jpg” 'https://api.om.qq.com/video/clientvideopic?access_token=ACCESS_TOKEN&md5=MD5&vid=VID'

·  参数列表

• 注意事项

    上传的视频文件有格式和大小限制，如下：

    大小：建议尺寸3：4，文件最大20MB

    格式：jpg，jpeg和png

• 返回数据

    {

      "code":"0",

      "msg": "success",

      "data": {

        "transaction_id":TRANSACTION_ID,

             "article_id":article_id //腾讯内容开放平台内容唯一id  

      }

    }

五、 发布短剧/修改短剧

• http请求方式:  URI: POST（请使用https协议）https://api.om.qq.com/articlev2/clientpubvideocollect?access_token=ACCESS_TOKEN

• 调用示例：

    curl -H 'Content-Type: application/json' "https://api.om.qq.com/articlev2/clientpubvideocollect?access_token=ACCESS_TOKEN" -d '{"title": TITLE, "cover_pic": COVER_PIC, "ext_info": EXTINFO, "content": CONTENT, "desc": DESC'

• 参数列表：

• 接口返参

{

"code":"0",

"msg": "success",

"data": {

"transaction_id":TRANSACTION_ID,

"article_id":article_id //腾讯内容开放平台内容唯一id

}

}

• ext_info 字段内容

短剧年代 period 取值如下：

短剧题材 subject 取值如下：

六、 删除文章

·  http请求方式： POST（请使用https协议） https://api.om.qq.com/article/deleteclient?access_token=ACCESS_TOKEN

·  POST数据格式: JSON

·  调用示例：

    curl -H 'Content-Type: application/json' "https://api.om.qq.com/article/deleteclient?access_token=ACCESS_TOKEN" -d '{"article_id": ARTICLE_ID}'

·  参数列表

·  返回数据

    {

      "code":"0",

      "msg": "success",

      "data": {

          }

      }

·  返回字段说明

七、 获取文章信息

·  http请求方式： GET（请使用https协议） https://api.om.qq.com/article/deleteclient?access_token=ACCESS_TOKEN

·  调用示例：

    curl 'https://api.om.qq.com/article/infoclient?access_token=ACCESS_TOKEN&article_id=ARTICLE_ID'

·  参数列表

·   返回数据

    {

      "code":"0",

      "msg": "success",

      "data": {

        "article_info": {

          "article_abstract": "海南琼海加详文艺队广场舞 《故乡是北京》 表演",

          "article_imgurl": "http://inews.gtimg.com/newsapp_ls/0/1179086390_196130/0",

          "article_pub_flag": "发布成功",

          "article_pub_time": "2017-03-04 13:40:01",

          "article_title": "海南琼海加详文艺队广场舞 《故乡是北京》 表演",

          "article_type": "视频文章",

               "article_id": "20170314A06ARB",

          "article_url": "http://kuaibao.qq.com/s/20170314A06ARB00",

          "article_video_info": {

            "desc": "DESC",

            "title": "海南琼海加详文艺队广场舞 《故乡是北京》 表演",

            "type": "video",

            "vid": "p0380p4aku7"

          }

        }

      }

    }

·   返回字段说明

八、获取媒体信息

·  http请求方式： GET（请使用https协议） https://api.om.qq.com/media/basicinfoclient?access_token=ACCESS_TOKEN

·  调用示例：

    curl 'https://api.om.qq.com/media/basicinfoclient?access_token=ACCESS_TOKEN'

·  参数列表

·  返回数据

    {

      "code":"0",

      "msg": "success",

      "data": {

        "header": "http://inews.gtimg.com/newsapp_ls/0/183849551_100100/0",

        "nick": "测试"

      }

    }

·  返回字段说明

九、 获取事务信息

·  http请求方式： GET（请使用https协议） https://api.om.qq.com/transaction/infoclient?access_token=ACCESS_TOKEN

·  调用示例：

    curl 'https://api.om.qq.com/transaction/infoclient?access_token=ACCESS_TOKEN&transaction_id=TRANSACTION_ID'

·  参数列表

·  返回数据

    {

      "code":"0",

      "msg": "success",

      "data": {

        "article_info": {

          "article_abstract": "海南琼海加详文艺队广场舞 《故乡是北京》 表演",

          "article_imgurl": "http://inews.gtimg.com/newsapp_ls/0/1179086390_196130/0",

          "article_pub_flag": "发布成功",

          "article_pub_time": "2017-03-04 13:40:01",

          "article_title": "海南琼海加详文艺队广场舞 《故乡是北京》 表演",

          "article_type": "视频文章",

          "article_url": "http://kuaibao.qq.com/s/20170314A06ARB00",

          "article_video_info": {

            "desc": "DESC",

            "title": "海南琼海加详文艺队广场舞 《故乡是北京》 表演",

            "type": "video",

            "vid": "p0380p4aku7"

          }

        },

      "transaction_ctime": "2017-03-04 13:40:00",

      "transaction_id": "8130591057953547123",

      "transaction_status": "成功",

      "transaction_type": "文章"

      }

    }

·  返回字段说明

十、 获取媒体信息

·  http请求方式： GET（请使用https协议） https://api.om.qq.com/media/basicinfoclient?access_token=ACCESS_TOKEN

·  调用示例：

    curl 'https://api.om.qq.com/media/basicinfoclient?access_token=ACCESS_TOKEN'

·  参数列表

·  返回数据

    {

      "code":"0",

      "msg": "success",

      "data": {

        "header": "http://inews.gtimg.com/newsapp_ls/0/183849551_100100/0",

        "nick": "测试"

      }

    }

·   返回字段说明

十一、 获取授权用户文章列表

·  http请求方式： GET（请使用https协议） https://api.om.qq.com/article/clientlist?access_token=ACCESS_TOKEN

·  调用示例：

    curl 'https://api.om.qq.com/article/clientlist?access_token=ACCESS_TOKEN&page=PAGE&limit=LIMIT'

·  参数列表

·   返回数据

    {

      "code":"0",

      "msg": "success",

      "data": {

        "articles": [

          {

            "article_abstract": "海南琼海加详文艺队广场舞 《故乡是北京》 表演",

            "article_imgurl": "http://inews.gtimg.com/newsapp_ls/0/1179086390_196130/0",

            "article_pub_flag": "发布成功",

            "article_pub_time": "2017-03-04 13:40:01",

            "article_title": "海南琼海加详文艺队广场舞 《故乡是北京》 表演",

            "article_type": "视频文章",

            "article_url": "http://kuaibao.qq.com/s/20170314A06ARB00",

            "article_video_info": {

              "desc": "DESC",

              "title": "海南琼海加详文艺队广场舞 《故乡是北京》 表演",

              "type": "video",

              "vid": "p0380p4aku7"

            }

          },

          {

            "article_abstract": "视频发布开放平台测试"

            "article_imgurl": "",

            "article_pub_flag": "发布成功",

            "article_pub_time": "2017-03-04 18:40:01",

            "article_title": "视频发布开放平台测试",

            "article_type": "视频文章",

            "article_url": "http://kuaibao.qq.com/s/20170314A06ARB00",

            "article_video_info": {

              "desc": "DESC",

              "title": "视频发布开放平台测试",

              "type": "video",

              "vid": "p0380p4aku7"

            }

          },

        ],

        "limit": "2",

        "page": "1",

        "total": "28"

      }

    }

·   返回字段说明

腾讯内容开放平台应用支持视频分片上传

• 视频分片上传发文主要包含三个步骤
  1.申请视频上传，开放平台返回上传的唯一事务transaction_id
  2.分片视频上传，根据transaction_id，将需要的视频文件分片上传到开放平台，后台会以第一次上传的分片为依据给出后续需要的数据库起始和结束地址，单个分片最大不超过（100MB）
  3.上传完成后，使用视频vid发布视频文章

十二、 申请视频上传接口

·  http请求方式： POST（请使用https协议） https://api.om.qq.com/video/clientuploadready?access_token=ACCESS_TOKEN

·  POST数据格式: JSON

·  调用示例：

    curl -H 'Content-Type: application/json' "https://api.om.qq.com/article/deleteclient?access_token=ACCESS_TOKEN" -d '{"size": SIZE, "sha": SHA, "md5": MD5}'

·  参数列表

·   返回数据
    返回用于视频分片上传的唯一事务id

    {

      "code":"0",

      "msg": "success",

      "data": {

        "transaction_id":TRANSACTION_ID

      }

    }

十三、 视频文件分片上传接口

·  http请求方式： POST（请使用https协议） https://api.om.qq.com/video/clientuploadtrunk?access_token=ACCESS_TOKEN

·  POST数据格式: FORM

·  调用示例：

    curl -F "mediatrunk=@test.wmv" "https://api.om.qq.com/video/clientuploadtrunk?access_token=ACCESS_TOKEN&transaction_id=TRANSACTION_ID"

·  参数列表

·   返回数据

    {

      "code":"0",

      "msg": "success",

      "data": {

        "end_offset":366141305,

        "start_offset":314572800,

        "transaction_id":TRANSACTION_ID

      }

    }

·   返回字段说明

    ·   注意事项
关于分片的其实和结束位置，特举例说明：
例如，视频第一次上传的时候start_offset设置为0，此处需要上传的视频文件大小为366141306，

    curl

    -X POST

    "https://api.om.qq.com/video/clientuploadtrunk" 

    -F "access_token=XXXXXXX"

    -F "transaction_id=TRANSACTION_ID"

    -F "start_offset=0"

    -F "mediatrunk=@test1.wmv"

    后台会以第一次上传的视频分片大小默认为该视频上传分片大小，后续都需要遵守该分片大小，除去最后一块分片不满足大小例外，例如实例处上传了100MB，即[0，104857599]此时后台会返回：

    {

      "code":"0",

      "msg": "success",

      "data": {

        "end_offset":209715199,

        "start_offset":104857600,

        "transaction_id":TRANSACTION_ID

      }

    }

    此处希望用户下一次分片上传文件区间为[104857600, 209715199]，此时需要上传请求为

    curl

    -X POST

    "https://api.om.qq.com/video/clientuploadtrunk" 

    -F "access_token=XXXXXXX"

    -F "transaction_id=TRANSACTION_ID"

    -F "start_offset=104857600"

    -F "mediatrunk=@test1.wmv"

    依次类推，用户一共需要分片四次，最后一次服务器上传时会返回：

    {

      "code":"0",

      "msg": "success",

      "data": {

        "end_offset":366141306,

        "start_offset":366141306,

        "transaction_id":TRANSACTION_ID

      }

    }

    如果返回的起始和结束地址是一样的，并且等于文件大小，表示文件已经上传完成，此时可以调用第三布的视频id发表视频文章的逻辑发文

    上传的视频文件有格式和大小限制，如下：

    分片：单次分片最大500MB,视频文件最大4G

    格式：

    常见在线流媒体格式：mp4、flv、f4v、webm

    移动设备格式：m4v、mov、3gp、3g2

    RealPlayer ：rm、rmvb

    微软格式 ：wmv、avi、asf

    MPEG 视频 ：mpg、mpeg、mpe、ts

    DV格式 ：div、dv、divx

    其他格式 ：vob、dat、mkv、swf、lavf、cpk、dirac、ram、qt、fli、flc、mod

    主流音频格式：mp3、aac、ac3、wav、m4a、ogg

十四、 根据vid发布视频文章

    分片上传完成后，可以根据事务id（transaction_id）拉取信息，如果成功会有返回视频vid

·  http请求方式： POST（请使用https协议） https://api.om.qq.com/articlev2/clientpubvideo?access_token=ACCESS_TOKEN

·  POST数据格式: JSON

·  调用示例：

    curl -H 'Content-Type: application/json' "https://api.om.qq.com/articlev2/clientpubvideo?access_token=ACCESS_TOKEN" -d '{"title": TITLE, "tags": TAGS, "vid": VID, "cat": CAT, "desc": DESC}'

·   参数列表

·  返回数据

    {

      "code":"0",

      "msg": "success",

      "data": {

        "transaction_id":TRANSACTION_ID,

        "article_id":article_id //腾讯内容开放平台内容唯一id

      }

    }

数据统计

十五、 获取媒体最新统计总数据

·  http请求方式： GET（请使用https协议） https://api.om.qq.com/media/statsclient?access_token=ACCESS_TOKEN

·  调用示例：

    curl 'https://api.om.qq.com/media/statsclient?access_token=ACCESS_TOKEN'

·  参数列表

·  返回数据

    {

        "code": 0,

        "data": {

            "read": 1,  //阅读量

            "play_total": 0     //视频总播放量

        },

        "msg": "SUCCESS"

    }

十六、按日期获取媒体统计数据

·  http请求方式： GET（请使用https协议） https://api.om.qq.com/media/statsdailyclient?access_token=ACCESS_TOKEN

·  调用示例：

    curl 'https://api.om.qq.com/media/statsdailyclient?access_token=ACCESS_TOKEN&begin_date=BEGIN_DATE&end_date=END_DATE'

·  参数列表

·  返回数据

    {

        "code": 0,

        "data": [

         {

                           "statistic_date":"2017-12-06",  //统计日期

            "read": 1,  //阅读量

            "play_total": 0     //视频总播放量

            },

        {

        "statistic_date":"2017-12-15",

        "read":0,

        "play_total":0

        },

        {

        "statistic_date":"2017-12-14",

        "read":0,

        "play_total":0

        }

      ],

        "msg": "SUCCESS"

    }

十七、 获取文章最新总数据

·  http请求方式： GET（请使用https协议） https://api.om.qq.com/article/statsclient?access_token=ACCESS_TOKEN

·  调用示例：

    curl 'https://api.om.qq.com/article/statsclient?access_token=ACCESS_TOKEN&article_id=ARTICLE_ID'

·  参数列表

·  返回数据

    {

        "code": 0,

        "data": {

            "read": 0, //阅读量

            "play_total": 0,    //播放次数，如果视频文章会有数值

        },

        "msg": "SUCCESS"

    }

十八、 获取文章按日期统计数据

·  http请求方式： GET（请使用https协议） https://api.om.qq.com/article/statsdailyclient?access_token=ACCESS_TOKEN

·  调用示例：

    curl 'https://api.om.qq.com/article/statsdailyclient?access_token=ACCESS_TOKEN&article_id=ARTICLE_ID&begin_date=BEGIN_DATE&end_date=END_DATE'

·   参数列表

·   返回数据

    {

        "code": 0,

        "data": [

            {

                "statistic_date": "2017-12-16",

                "read": 0, //阅读量

                "play_total": 0 //播放次数，如果视频文章会有数值

            },

            {

                "statistic_date": "2017-12-15",

                "read": 0,

                "play_total": 0

            },

            {

                "statistic_date": "2017-12-14",

                "read": 0,

                "play_total": 0

            }

        ],

        "msg": "SUCCESS"

    }

接口访问频次

腾讯内容开放平台接口限制每段时间只能请求一定的次数。限制的单位时间是每天；限制的维度有但授权腾讯内容开放平台用户；部分特殊接口有单独的请求次数限制。 例如： 单腾讯内容开放平台授权用户RTMP直播发文每天只能请求5次。

当调用接口不能满足开发需求，欢迎申请合作伙伴洽谈。在保证用户隐私及信息安全的前提下，本着合作、合法、互利的原则，进行深度合作。

接口返回码说明