单条节目详细信息

1. 接口描述

URL https://openapi.youku.com/router/rest.json
功能描述 单条节目详细信息
返回格式 Json,UTF8
HTTP请求方式 GET
当前接口版本 V3
历史接口版本 V2

2. 系统参数

参数名 参数全称 必选 参数类型 参数描述
action action true String youku.content.program.single.deltail.get
client_id client_id true String 应用的client id
access_token access token false String oauth2的token
timestamp timestamp true String 客户端当前时间戳,精确到秒,timestamp与开放平台请求时间误差为6分钟
version version true String API协议版本,默认值3.0
sign_method sign_method false String 签名的摘要算法,可选值为:HmacSHA256,md5。默认为md5
sign sign true String 对API调用参数(除sign外)的md5加密值。详情见签名方法

3. 业务参数

参数名 参数全称 必选 参数类型 参数描述
q query true String q=showid:$showid
fd field true String fd为一系列字段,详见注意事项部分.

4. 返回参数

参数名 参数全称 必选 参数类型 参数描述
copyright_status copyright_status true String 版权状态,authorized 已授权, public 公共版权, falseauth 伪授权,unknow 版权未知, expired 版权过期, unauthorized 无版权
state state true String 节目状态: normal - 正常 limited - 分级 check - 待审 checking- 审核 blocked - 屏蔽 deleted - 删除 delayed - 延审 paycheck - 付费待审
douban_num douban_num true String 豆瓣(douban)对应节目编号
showtotal_down showtotal_down true String 节目总“踩”数
showtotal_up showtotal_up true String 节目总“顶”数
series series true String 所属系列名称
seriesid seriesid true String 所属系列名称
showseq showseq true String 节目在所属系列
pay_type pay_type true String[] 付费类型:支持点播(vod) 支持包月(mon)
price price true String 节目价格(单位:分)
permit_duration permit_duration true String 消费期(收费节目)(天)
offlinetime offlinetime true String 节目下线时间(YYYY-MM-DD HH:NN:SS),查寻时传送格式:YYYYMMDD或YYYYMMDDHHNNSS
onlinetime onlinetime true 节目上线时间(YYYY-MM-DD HH:NN:SS),查寻时传送格式:YYYYMMDD或YYYYMMDDHHNNSS
teacher teacher true String[] 主讲教师
composer composer true String[] 作曲
lyricswriter lyricswriter true String[] 作词
singer singer true String[] 演唱者
voice voice true String[] 配音
tv_station tv_station true String[] 电视台
host host true String[] 主持人
original original true String 原著
performer performer true String 演员
producer producer true String[] 出品人
screenwriter screenwriter true String[] 编剧
director director true String[] 导演
starring starring true String[] 主演
production production true String[] 制作公司
distributor distributor true String[] 发行公司或出品方,查寻时使用公司名称,结构:[{id:1001,name:“博纳影业”}]
showtotal_fav showtotal_fav true String 节目总收藏数
showtotal_comment showtotal_comment true String 节目总评论数
showweek_vv showweek_vv true String 节目一周播放总数(从当天向前推7天)
showday_vv showday_vv true String 节目一天播放总数(从“前天”开始计算,实际为24-48小时的数据)
showdesc showdesc true String 简介
site site true String[] 授权网站:youku(优酷) tudou(土豆),大部分节目,应该两个网站都支持
showcategory showcategory true String 节目主分类: 电影 电视剧 动漫 音乐 综艺 体育 教育 纪录片 资讯
releasedate_youku releasedate_youku true String 优酷发行时间(YYYY-MM-DD)
showcreatetime showcreatetime true String 节目创建时间(YYYY-MM-DD HH:NN:SS)
releasedate_mainland releasedate_mainland true String 大陆发行时间(YYYY-MM-DD)
releasedate releasedate true String 节目发行时间(YYYY-MM-DD)
reputation reputation true String 好评(0~10)
hasvideotype hasvideotype true String[] 包含的视频类型。正片,预告片,花絮,普通视频,资讯,MV,首映式,伪正片。不包含屏蔽视频、不显示视频和未锁定视频
showtotal_vv showtotal_vv true String 节目总播放数
update_notice update_notice true String 更新预告,如“每周四更新两集”
video_collected video_collected true 节目收集所有视频总数(含正片和周边)
episode_last episode_last true String 最后收录正片的集号(不计算屏蔽、未锁定、不显示的视频)
episode_total episode_total true String 正片总集数
area area true String[] 节目国家地区
news_genre news_genre true String[] 资讯类型,仅限资讯
doc_genre doc_genre true String[] 纪录片类型,仅限纪录片
anime_genre anime_genre true String[] 动漫类型,仅限动漫
edu_genre edu_genre true String[] 教育类型,仅限教育
tv_genre tv_genre true String[] 电视剧类型,仅限电视剧
variety_genre variety_genre true String[] 综艺类型,仅限综艺
sports_genre sports_genre true String[] 体育类型,仅限体育
movie_genre movie_genre true String[] 电影类型,仅限电影
mv_genre mv_genre true String[] 音乐风格,仅限音乐
streamtypes streamtypes true String[] 正片拥有的流格式:fileid flvhd flv hd(mp4hd) 3gp 3gphd hd2(720p)(mp4hd2) hd3(mp4hd3)(1080p) mp5sd mp5hd mp5hd2 mp5hd3 mp5hd4 规则:正片收录完成, 并且全部正片都有 节目才算这个有这个流格式
showid showid true String 节目ID,16进制小写, 例如75a63cd2b9a2489d3c1e
showname showname true String 节目名称
paid paid true 是否是收费节目。 0 - 免费 1 - 收费
pay_type pay_type true String[] 付费类型:支持点播(vod) 支持包月(mon)
showsubtitle showsubtitle true String 节目子标题
showalias showalias true String[] 节目别名 结构:[{'type':1,'alias':'KongFu Panda'},{…}],type:0中文 1英文

5. 调用示例

https://openapi.youku.com/router/rest.json?caller=NOVA&fd=video
&opensysparams={"sign": "9e4ad1ebc540b5b438b2818ab350dd1e", "version": "3.0", "format": "json", 
"timestamp": 1453718098, "access_token": "d9ce66ced641240836cf6011a4c195bc",
 "client_id": "163d4fd10c7f9a28", "action": "youku.content.program.single.deltail.get"}&q=showid:301983
  			

6. 响应示例

{
tokens: "showid:30595",
orderby: "",
offset: 1,
total: 1,
index_cost: 0,
results: [
{
reputation: 8.659,
update_notice: null,
showname: "如果爱",
showsubtitle: "陈可辛打造爱情音乐剧",
pk_odshow: "30595",
state: "normal",
site: [
"youku",
"tudou"
],
copyright_status: "authorized",
releasedate: "2005-12-01",
releasedate_mainland: "0000-00-00",
releasedate_youku: "0000-00-00",
onlinetime: "0000-00-00 00:00:00",
offlinetime: "0000-00-00 00:00:00",
pay_type: [ ],
douban_num: "1418070",
showcategory: "电影",
hasvideotype: [
"预告片",
"正片"
],
streamtypes: [
"hd2",
"flvhd",
"hd",
"mp5hd",
"mp5hd2"
],
showcreatetime: "2009-08-31 19:58:23",
id: 30595,
showseq: 0,
seriesid: 0,
price: 0,
permit_duration: 0,
showtotal_down: 288,
showtotal_up: 4891,
showtotal_fav: 1393,
showtotal_comment: 522,
showweek_vv: 9227,
showday_vv: 1607,
showtotal_vv: 1791236,
video_collected: 2,
episode_last: 1,
episode_total: 1,
paid: 0,
movie_genre: [
"剧情",
"爱情",
"歌舞",
"文艺"
],
tv_genre: [ ],
anime_genre: [ ],
mv_genre: [ ],
area: [
"大陆",
"香港",
"马来西亚"
],
variety_genre: [ ],
sports_genre: [ ],
edu_genre: [ ],
news_genre: [ ],
doc_genre: [ ],
showid: "cc07434e962411de83b1",
series: null,
showdesc: "想演戏的孙纳(周迅 饰)与想导戏的林见东(金城武 饰)初遇见时,两人都正处于生活与事业的低谷,在相互鼓励和扶携中,他们渐渐有了共同的可以看见希望的未来,然而孙纳更想把现在的可能抓到手,狠心与林见东分了手,跟了可以给她戏的导演聂文(张学友 饰),成为人人艳羡的大明星。   天意弄人,十年后孙纳与也做了演员的林见东因为一部合拍戏又重遇。虽努力说服自己忘记过去,却欺骗不了自己的心,孙纳陷入两难中。而更戏剧的是,孙纳、林见东和聂文要同演一出剧情与他们之间情恨纠葛惊人相似的戏。",
showalias: [
{
type: "0",
alias: "如果·爱"
},
{
type: "0",
alias: "毋忘我"
},
{
type: "0",
alias: "勿忘我"
},
{
type: "1",
alias: "Perhaps Love"
}
],
show_thumburl: "http://r2.ykimg.com/050B0000522422676758396219046C80",
director: [
{
id: "59725",
name: "陈可辛",
thumburl: "http://r1.ykimg.com/05130000532AA31667379F188508C57D"
}
],
performer: [
{
id: "17344",
name: "周迅",
thumburl: "http://r4.ykimg.com/051300004F96446F9792737BD50C5180",
character: [
"孙纳"
]
},
{
id: "13945",
name: "金城武",
thumburl: "http://r3.ykimg.com/05130000540FE51A67379F10B90772D2",
character: [
"林见东"
]
},
{
id: "12148",
name: "张学友",
thumburl: "http://r3.ykimg.com/051300004E9D42FF979273023B04E4B0",
character: [
"聂文"
]
},
{
id: "11730",
name: "曾志伟",
thumburl: "http://r2.ykimg.com/051300004EC5D01F9792732A9D083A56",
character: [
"制片人"
]
},
{
id: "16336",
name: "池珍熙",
thumburl: "http://r1.ykimg.com/0513000050DA757D979273460D03F4EA",
character: [
"Monty"
]
},
{
id: "12222",
name: "吴君如",
thumburl: "http://r3.ykimg.com/051300004E7952B497927336F2043586",
character: [
"林见东经纪人"
]
}
],
screenwriter: [
{
id: "104347",
name: "林爱华",
thumburl: "http://r1.ykimg.com/05130000533E260A67379F17AB0E016E"
},
{
id: "99039",
name: "杜国威",
thumburl: "http://r3.ykimg.com/051300004F7FC8119792732A2A078B26"
}
],
producer: [
{
id: "59725",
name: "陈可辛",
thumburl: "http://r1.ykimg.com/05130000532AA31667379F188508C57D"
},
{
id: "63306",
name: "安德鲁·摩根",
thumburl: "http://r3.ykimg.com/051300004EB3A6F197927317E0087EBD"
},
{
id: "369283",
name: "安晓芬",
thumburl: "http://r2.ykimg.com/05130000517B26559792731EBC059786"
}
],
distributor: [
{
id: "10410",
name: "天映娱乐",
type: "distributor"
},
{
id: "14156",
name: "甲上娱乐有限公司",
type: "distributor"
},
{
id: "31980",
name: "Wild Side Films",
type: "distributor"
}
],
production: [
{
id: "14156",
name: "甲上娱乐有限公司",
type: "production"
},
{
id: "20794",
name: "Ruddy Morgan Productions",
type: "production"
},
{
id: "49382",
name: "Morgan & Chan Films",
type: "production"
}
]
}
],
_errorCode: 0,
_errorDesc: null,
url_cost: 0.0055370330810547,
batch_url_cost: 0,
total_cost: 0.029845952987671
}
			

7. 异常示例

8. 注意事项

fd可选参数包括:series showseq seriesid pay_type price permit_duration offlinetime onlinetime teacher composer

lyricswriter singer voice tv_station host original performer starring producer screenwriter director

copyright_status state production distributor douban_num showtotal_down showtotal_up showtotal_fav

showtotal_comment showweek_vv showday_vv showdesc site showcategory releasedate_youku showcreatetime

releasedate_mainland releasedatereputation hasvideotype showtotal_vv update_notice video_collected

doc_genre anime_genre edu_genre sports_genre tv_genre variety_genre movie_genre mv_genre streamtypes showid

showname paid pay_type showsubtitle showalias show_thumburl episode_last episode_total area news_genre