| 第8行： | 第8行： | ||
params={{api_args|kandian_id|true|bigint|看点为合作方提供的ID。}} | params={{api_args|kandian_id|true|bigint|看点为合作方提供的ID。}} | ||
{{api_args|epg_id|true|bigint|视频节目的ID 。范围：1～9999999999。}} | {{api_args|epg_id|true|bigint|视频节目的ID 。范围：1～9999999999。}} | ||
| − | {{api_args|time|false|int| | + | {{api_args|time|false|int|截图时间点，以秒为单位，范围：0～500000。}} |
{{api_args|format|false|string|返回图片格式，可选jpg、gif，默认为gif。}}| | {{api_args|format|false|string|返回图片格式，可选jpg、gif，默认为gif。}}| | ||
result= | result= | ||
2012年6月6日 (三) 11:26的版本
kandian/epg/screenshot
通过epg_id获取此节目在指定时间的截图
URL
https://api.weibo.com/2/kandian/epg/screenshot.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权，参见 如何登录授权
访问授权限制
访问级别：普通接口
频次限制：是
关于频次限制，参见 接口访问权限说明
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | true | 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"
}
关于错误返回值与错误代码，参见 错误代码说明
返回字段说明
其余字段同微博，annotations字段说明：
| 返回值字段 | 字段类型 | 字段说明 |
|---|---|---|
| feedId | bigint | 行为id |
| epgId | bigint | 节目id |
其他
无
相关问题
{{{relat_qa}}}
到 帮助中心 查看更多问题或提问
