2/kandian/tv/program
(未显示1个用户的7个中间版本) | |||
第1行: | 第1行: | ||
− | {{ | + | {{kandian_api_desc_v2| |
+ | funcDesc=获取电视台节目列表| | ||
uri=kandian/tv/program| | uri=kandian/tv/program| | ||
desc=根据电视台id和时间获取看点电视台的节目列表| | desc=根据电视台id和时间获取看点电视台的节目列表| | ||
httpMethod=GET| | httpMethod=GET| | ||
− | needAuth= | + | needAuth=是| |
level={{Api_L1}}| | level={{Api_L1}}| | ||
rateLimit=是| | rateLimit=是| | ||
− | params= | + | params={{api_args|tvid|true|int|电视台id。}} |
− | {{api_args|tvid|true|int|电视台id。}} | + | {{api_args|now|false|int|取值0或1。默认为0,为0时要与date配合使用。为1表示获取当前直播节目。}} |
− | {{api_args|now|false| | + | |
{{api_args|date|false|string|(YYYY-mm-dd) 默认为当天。}}| | {{api_args|date|false|string|(YYYY-mm-dd) 默认为当天。}}| | ||
result= | result= | ||
<pre> | <pre> | ||
{ | { | ||
− | total_number: 2 , | + | "total_number": 2, |
− | tvid: 1, | + | "tvid": 1, |
− | program: [{ | + | "program": [{ |
− | epg_id: "930616370", | + | "epg_id": "930616370", |
− | epg_title: "档案20111106", | + | "epg_title": "档案20111106", |
− | start_time: "1320510780", | + | "start_time": "1320510780", |
− | end_time: "1320512700", | + | "end_time": "1320512700", |
}, | }, | ||
{ | { | ||
− | epg_id: "930616380" | + | "epg_id": "930616380" |
− | epg_title: "黎明之前(5)20111106" | + | "epg_title": "黎明之前(5)20111106" |
− | start_time: "1320512700" | + | "start_time": "1320512700" |
− | end_time: "1320515400" | + | "end_time": "1320515400" |
}] | }] | ||
} | } | ||
</pre>| | </pre>| | ||
− | resultDes={{ | + | resultDes={{Rdes_kandian_tv_program}}| |
useAge=*无| | useAge=*无| | ||
otherInfo=无 | otherInfo=无 | ||
}}{{#a:showgrade}} | }}{{#a:showgrade}} |
2012年8月24日 (五) 16:53的最后版本
接口功能
根据电视台id和时间获取看点电视台的节目列表
URL
https://api.weibo.com/2/kandian/tv/program.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
访问级别:普通接口
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | false | string | 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。 |
access_token | false | string | 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。 |
kandian_id | true | bigint | 看点为合作方提供的ID。 |
tvid | true | int | 电视台id。 |
now | false | int | 取值0或1。默认为0,为0时要与date配合使用。为1表示获取当前直播节目。 |
date | false | string | (YYYY-mm-dd) 默认为当天。 |
注意事项
- 无
返回结果
JSON示例
{ "total_number": 2, "tvid": 1, "program": [{ "epg_id": "930616370", "epg_title": "档案20111106", "start_time": "1320510780", "end_time": "1320512700", }, { "epg_id": "930616380" "epg_title": "黎明之前(5)20111106" "start_time": "1320512700" "end_time": "1320515400" }] }
关于错误返回值与错误代码,参见 看点错误代码说明
字段说明
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
total_number | int | 节目个数 |
tvid | int | 电视台id |
epg_id | int | 节目Id |
epg_title | string | 节目名称 |
start_time | int | 开始时间 |
end_time | int | 结束时间 |
其他
无
文档更新时间: 2012-08-24