2/kandian/epg/screenshot
接口功能
通过epg_id获取此节目在指定时间的截图
URL
https://api.weibo.com/2/kandian/epg/screenshot.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
访问级别:普通接口
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | false | string | 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。 |
access_token | false | string | 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。 |
kandian_id | true | bigint | 看点为合作方提供的ID。 |
epg_id | true | bigint | 视频节目的ID 。范围:1~9999999999。 |
time | false | int | 截图时间点,以秒为单位,范围:0~500000。 |
format | false | string | 返回图片格式,可选jpg、gif,默认为gif。 |
注意事项
- 若不传time参数则获取服务器当前时间与视频开始时间之差。
- 只有点直播混跑系统的视频才能用此接口。(后续会支持点播,暂未开发)
返回结果
JSON示例
{ "epg_id": "920790380", "time": 36, "pic_path ": "http://pic.kandian.com/snapshots/jt/930679520_4385000.jpg" }
关于错误返回值与错误代码,参见 看点错误代码说明
字段说明
无
其他
无