淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
show_id	String	必须	jowekrj		节目id

名称	类型	示例值	描述
result	Result	-	result
└ code String SUCCESS code └ detail_message String - detailMessage └ message String 成功 message └ success Boolean true success value SingleShowResult - 数据详情 show Show - 节目详情 └ area String 大陆、香港国家地区 └ category String 电影节目一级分类 └ description String 孙悟空（周星驰饰）护送唐三藏（罗家英饰）去西天取经路上，与牛魔王（陆树铭饰）合谋欲杀害唐三藏，并偷走了月光宝盒，此举使观音萌生将其铲除心思，经唐三藏请求，孙悟空被判五百年后重新投胎做人赎其罪孽。　　五百年后孙悟空化身强盗头头至尊宝（周星驰饰）。当遇见预谋吃唐僧肉的妖怪姐妹蜘蛛精春三十娘（蓝洁瑛饰）和白骨精白晶晶（莫文蔚饰）时，因为五百年前孙悟空曾与白晶晶有过一段恋情，至尊宝与她一见钟情，但因菩提老祖（刘镇伟饰）将二人妖怪身份相告，至尊宝仍带领众强盗开始与二妖展开周旋，过程中，白晶晶为救至尊宝打伤春三十娘，自己也中毒受伤，为了救白晶晶，至尊宝去找春三十娘，遭白晶晶误会，绝望自杀，至尊宝开始用月光宝盒以期使时光倒流。描述 └ paid Number 0 是否收费，0=免费，1=收费（看try_type是否为time，如果为time，则试看try_time时长，否则不支持试看）） └ show_id String cc036ab2962411de83b1 节目id └ status String 在线数娱节目状态，"在线"，"下线" └ sub_category String 奇幻、冒险、动作、喜剧、爱子分类 └ thumb_url String https://r1.ykimg.com/050C000051D6667F6758397997070849 海报(横版) └ title String 大话西游节目名称 └ try_episodes Number 0 试看集数(已废弃) └ try_time Number 0 试看集长(秒) └ try_type String cannot 试看类型:不支持试看(cannot) 节目按时长试看(time) 节目按集数试看(episodes) └ vthumb_url String https://r1.ykimg.com/050E000051D666A267583979CB05E2DE 海报(竖版) director_list Person [] - 导演 └ charactor String - 角色名 └ name String 刘镇伟名字 └ thumb_url String http://r4.ykimg.com/05130000579EB81967BC3C0ABE0C57C1 人物图片 └ id Number 1234 id └ license_list String [] CIBN 内容牌照列表 performer_list Person [] - 演员列表 └ charactor String 至尊宝角色名 └ name String 周星驰名字 └ thumb_url String http://r3.ykimg.com/051300004E9F968697927334AC024BFD 人物图片 └ id Number 1234 id starring_list Person [] - 主演列表 └ charactor String 至尊宝描述 └ name String 周星驰名字 └ thumb_url String http://r3.ykimg.com/051300004E9F968697927334AC024BFD 人物图片 └ id Number 1234 id └ web_url String http://www.soku.com/detail/show/XNDAwMDQ= pc地址 └ episode_count String 12 总集数 └ keyword String ["大话西游1","大话西游一","月光宝盒","大话西游"] 关键字列表 └ language_list String [] 国语语言列表 └ pay_type_list String [] mon 付费类型:支持点播(vod) 支持包月(mon) └ price Number 0 价格（分） └ release_date String 1993-08-01 00:00:00 发布时间 └ small_thumb_url String https://r1.ykimg.com/0515000051D6667F6758397997070849 海报(横版缩略图) └ small_vthumb_url String https://r1.ykimg.com/0516000051D666A267583979CB05E2DE 海报(竖版缩略图) └ check_state_list String [] CIBN 节目校验通过牌照列表（目前只针对CIBN有用） └ keyword_list String [] ["大话西游1","大话西游一","月光宝盒","大话西游"] 关键字列表(数组) └ youku_rating String 7.431 优酷评分 └ exclusive Boolean true exclusive └ vod_ticket Boolean true 点播是否可用券，这个值此节目是单点的情况下才用用 └ license_num String (沪)剧审网字(2015)第0001号 licenseNum └ huge_vthumb_url String https://r1.ykimg.com/0515000051D6667F6758397997070849 节目超大海报 └ huge_thumb_url String https://r1.ykimg.com/0515000051D6667F6758397997070849 节目超大海报（竖） └ tags String 孙悟空标签信息 └ releasedate_youku String 1993-08-01 00:00:00 优酷发行时间 └ show_kind String ["PGC","文化"] 节目性质 └ liveid String [1111] 直播间id，可能有多个 └ completed Boolean false 是否完结 └ play_state String {"big":1,"small":0} 大小屏是否可用 └ age_group String ["13到15岁","16到17岁"] 年龄组 └ kids_age_max Number 99 少儿用最大年龄 └ kids_age_min Number 1 少儿用最小年龄 └ episode_last Number 6 最新更新集数 └ update_notice String 每天24点更新更新提示 └ sub_title String 奋斗节目副标题 guest_list PersonOuterDto [] - 嘉宾列表 └ thumb_url String http://r3.ykimg.com/051300004E9F968697927334AC024BFD 人物图片 └ name String 孙岳名字 └ id Number 1234 id └ charactor String 小岳岳角色名 host_list PersonOuterDto [] - 主持人 └ thumb_url String http://r3.ykimg.com/051300004E9F968697927334AC024BFD 人物图片 └ name String 郭德刚名字 └ id Number 124 id └ charactor String 刚子角色名 └ alias String [] ["大话西游1","大话西游一","月光宝盒","大话西游"] 节目别名列表 materials ShowMaterialDto [] [{"updateTime":"2018-08-01 00:00:00","url":"http://r3.ykimg.com/051300004E9F968697927334AC024BFD"}] 素材列表 └ update_time String http://r3.ykimg.com/051300004E9F968697927334AC024BFD 素材更新时间 └ url String 2018-08-01 00:00:00 素材url └ play_features String {"CIBN":1024} 节目播放特性 └ small_episode_last Number 23 最新更新集数（小屏） └ small_update_notice String 每天24点更新更新提示（小屏） └ small_completed Boolean false 是否完结（小屏） └ download_status String 下载状态

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
VmacFullShowGetRequest req = new VmacFullShowGetRequest();
req.setShowId("jowekrj");
VmacFullShowGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
VmacFullShowGetRequest req = new VmacFullShowGetRequest();
req.ShowId = "jowekrj";
VmacFullShowGetResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new VmacFullShowGetRequest;
$req->setShowId("jowekrj");
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.vmac.full.show.get' \
-d 'partner_id=apidoc' \
-d 'sign=727430F19D9EB2F4A0EEAD009F1E6D23' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-04+12%3A08%3A55' \
-d 'v=2.0' \
-d 'show_id=jowekrj'

# -*- coding: utf-8 -*-
import top.api

req=top.api.VmacFullShowGetRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.show_id="jowekrj"
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.vmac.full.show.get");
add_param(pRequest,"show_id","jowekrj");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.vmac.full.show.get', {
	'show_id':'jowekrj'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<vmac_full_show_get_response>
    <result>
        <code>SUCCESS</code>
        <detail_message>-</detail_message>
        <message>成功</message>
        <success>true</success>
        <value>
            <show>
                <area>大陆、香港</area>
                <category>电影</category>
                <description>孙悟空（周星驰 饰）护送唐三藏（罗家英 饰）去西天取经路上，与牛魔王（陆树铭 饰）合谋欲杀害唐三藏，并偷走了月光宝盒，此举使观音萌生将其铲除心思，经唐三藏请求，孙悟空被判五百年后重新投胎做人赎其罪孽。 　　五百年后孙悟空化身强盗头头至尊宝（周星驰 饰）。当遇见预谋吃唐僧肉的妖怪姐妹蜘蛛精春三十娘（蓝洁瑛 饰）和白骨精白晶晶（莫文蔚 饰）时，因为五百年前孙悟空曾与白晶晶有过一段恋情，至尊宝与她一见钟情，但因菩提老祖（刘镇伟 饰）将二人妖怪身份相告，至尊宝仍带领众强盗开始与二妖展开周旋，过程中，白晶晶为救至尊宝打伤春三十娘，自己也中毒受伤，为了救白晶晶，至尊宝去找春三十娘，遭白晶晶误会，绝望自杀，至尊宝开始用月光宝盒以期使时光倒流。</description>
                <paid>0</paid>
                <show_id>cc036ab2962411de83b1</show_id>
                <status>在线</status>
                <sub_category>奇幻、冒险、动作、喜剧、爱</sub_category>
                <thumb_url>https://r1.ykimg.com/050C000051D6667F6758397997070849</thumb_url>
                <title>大话西游</title>
                <try_episodes>0</try_episodes>
                <try_time>0</try_time>
                <try_type>cannot</try_type>
                <vthumb_url>https://r1.ykimg.com/050E000051D666A267583979CB05E2DE</vthumb_url>
                <director_list>
                    <person>
                        <charactor>-</charactor>
                        <name>刘镇伟</name>
                        <thumb_url>http://r4.ykimg.com/05130000579EB81967BC3C0ABE0C57C1</thumb_url>
                        <id>1234</id>
                    </person>
                </director_list>
                <license_list>
                    <string>CIBN</string>
                </license_list>
                <performer_list>
                    <person>
                        <charactor>至尊宝</charactor>
                        <name>周星驰</name>
                        <thumb_url>http://r3.ykimg.com/051300004E9F968697927334AC024BFD</thumb_url>
                        <id>1234</id>
                    </person>
                </performer_list>
                <starring_list>
                    <person>
                        <charactor>至尊宝</charactor>
                        <name>周星驰</name>
                        <thumb_url>http://r3.ykimg.com/051300004E9F968697927334AC024BFD</thumb_url>
                        <id>1234</id>
                    </person>
                </starring_list>
                <web_url>http://www.soku.com/detail/show/XNDAwMDQ=</web_url>
                <episode_count>12</episode_count>
                <keyword>[&quot;大话西游1&quot;,&quot;大话西游一&quot;,&quot;月光宝盒&quot;,&quot;大话西游&quot;]</keyword>
                <language_list>
                    <string>国语</string>
                </language_list>
                <pay_type_list>
                    <string>mon</string>
                </pay_type_list>
                <price>0</price>
                <release_date>1993-08-01 00:00:00</release_date>
                <small_thumb_url>https://r1.ykimg.com/0515000051D6667F6758397997070849</small_thumb_url>
                <small_vthumb_url>https://r1.ykimg.com/0516000051D666A267583979CB05E2DE</small_vthumb_url>
                <check_state_list>
                    <string>CIBN</string>
                </check_state_list>
                <keyword_list>
                    <string>[&quot;大话西游1&quot;</string>
                    <string>&quot;大话西游一&quot;</string>
                    <string>&quot;月光宝盒&quot;</string>
                    <string>&quot;大话西游&quot;]</string>
                </keyword_list>
                <youku_rating>7.431</youku_rating>
                <exclusive>true</exclusive>
                <vod_ticket>true</vod_ticket>
                <license_num>(沪)剧审网字(2015)第0001号</license_num>
                <huge_vthumb_url>https://r1.ykimg.com/0515000051D6667F6758397997070849</huge_vthumb_url>
                <huge_thumb_url>https://r1.ykimg.com/0515000051D6667F6758397997070849</huge_thumb_url>
                <tags>孙悟空</tags>
                <releasedate_youku>1993-08-01 00:00:00</releasedate_youku>
                <show_kind>[&quot;PGC&quot;,&quot;文化&quot;]</show_kind>
                <liveid>[1111]</liveid>
                <completed>false</completed>
                <play_state>{&quot;big&quot;:1,&quot;small&quot;:0}</play_state>
                <age_group>[&quot;13到15岁&quot;,&quot;16到17岁&quot;]</age_group>
                <kids_age_max>99</kids_age_max>
                <kids_age_min>1</kids_age_min>
                <episode_last>6</episode_last>
                <update_notice>每天24点更新</update_notice>
                <sub_title>奋斗</sub_title>
                <guest_list>
                    <person_outer_dto>
                        <thumb_url>http://r3.ykimg.com/051300004E9F968697927334AC024BFD</thumb_url>
                        <name>孙岳</name>
                        <id>1234</id>
                        <charactor>小岳岳</charactor>
                    </person_outer_dto>
                </guest_list>
                <host_list>
                    <person_outer_dto>
                        <thumb_url>http://r3.ykimg.com/051300004E9F968697927334AC024BFD</thumb_url>
                        <name>郭德刚</name>
                        <id>124</id>
                        <charactor>刚子</charactor>
                    </person_outer_dto>
                </host_list>
                <alias>
                    <string>[&quot;大话西游1&quot;</string>
                    <string>&quot;大话西游一&quot;</string>
                    <string>&quot;月光宝盒&quot;</string>
                    <string>&quot;大话西游&quot;]</string>
                </alias>
                <materials>
                    <show_material_dto>
                        <update_time>http://r3.ykimg.com/051300004E9F968697927334AC024BFD</update_time>
                        <url>2018-08-01 00:00:00</url>
                    </show_material_dto>
                </materials>
                <play_features>{&quot;CIBN&quot;:1024}</play_features>
                <small_episode_last>23</small_episode_last>
                <small_update_notice>每天24点更新</small_update_notice>
                <small_completed>false</small_completed>
                <download_status></download_status>
            </show>
        </value>
    </result>
</vmac_full_show_get_response>

{
    "vmac_full_show_get_response":{
        "result":{
            "code":"SUCCESS",
            "detail_message":"-",
            "message":"成功",
            "success":true,
            "value":{
                "show":{
                    "area":"大陆、香港",
                    "category":"电影",
                    "description":"孙悟空（周星驰 饰）护送唐三藏（罗家英 饰）去西天取经路上，与牛魔王（陆树铭 饰）合谋欲杀害唐三藏，并偷走了月光宝盒，此举使观音萌生将其铲除心思，经唐三藏请求，孙悟空被判五百年后重新投胎做人赎其罪孽。 　　五百年后孙悟空化身强盗头头至尊宝（周星驰 饰）。当遇见预谋吃唐僧肉的妖怪姐妹蜘蛛精春三十娘（蓝洁瑛 饰）和白骨精白晶晶（莫文蔚 饰）时，因为五百年前孙悟空曾与白晶晶有过一段恋情，至尊宝与她一见钟情，但因菩提老祖（刘镇伟 饰）将二人妖怪身份相告，至尊宝仍带领众强盗开始与二妖展开周旋，过程中，白晶晶为救至尊宝打伤春三十娘，自己也中毒受伤，为了救白晶晶，至尊宝去找春三十娘，遭白晶晶误会，绝望自杀，至尊宝开始用月光宝盒以期使时光倒流。",
                    "paid":0,
                    "show_id":"cc036ab2962411de83b1",
                    "status":"在线",
                    "sub_category":"奇幻、冒险、动作、喜剧、爱",
                    "thumb_url":"https:\/\/r1.ykimg.com\/050C000051D6667F6758397997070849",
                    "title":"大话西游",
                    "try_episodes":0,
                    "try_time":0,
                    "try_type":"cannot",
                    "vthumb_url":"https:\/\/r1.ykimg.com\/050E000051D666A267583979CB05E2DE",
                    "director_list":{
                        "person":[
                            {
                                "charactor":"-",
                                "name":"刘镇伟",
                                "thumb_url":"http:\/\/r4.ykimg.com\/05130000579EB81967BC3C0ABE0C57C1",
                                "id":1234
                            }
                        ]
                    },
                    "license_list":{
                        "string":[
                            "CIBN"
                        ]
                    },
                    "performer_list":{
                        "person":[
                            {
                                "charactor":"至尊宝",
                                "name":"周星驰",
                                "thumb_url":"http:\/\/r3.ykimg.com\/051300004E9F968697927334AC024BFD",
                                "id":1234
                            }
                        ]
                    },
                    "starring_list":{
                        "person":[
                            {
                                "charactor":"至尊宝",
                                "name":"周星驰",
                                "thumb_url":"http:\/\/r3.ykimg.com\/051300004E9F968697927334AC024BFD",
                                "id":1234
                            }
                        ]
                    },
                    "web_url":"http:\/\/www.soku.com\/detail\/show\/XNDAwMDQ=",
                    "episode_count":"12",
                    "keyword":"[\"大话西游1\",\"大话西游一\",\"月光宝盒\",\"大话西游\"]",
                    "language_list":{
                        "string":[
                            "国语"
                        ]
                    },
                    "pay_type_list":{
                        "string":[
                            "mon"
                        ]
                    },
                    "price":0,
                    "release_date":"1993-08-01 00:00:00",
                    "small_thumb_url":"https:\/\/r1.ykimg.com\/0515000051D6667F6758397997070849",
                    "small_vthumb_url":"https:\/\/r1.ykimg.com\/0516000051D666A267583979CB05E2DE",
                    "check_state_list":{
                        "string":[
                            "CIBN"
                        ]
                    },
                    "keyword_list":{
                        "string":[
                            "[\"大话西游1\"",
                            "\"大话西游一\"",
                            "\"月光宝盒\"",
                            "\"大话西游\"]"
                        ]
                    },
                    "youku_rating":"7.431",
                    "exclusive":true,
                    "vod_ticket":true,
                    "license_num":"(沪)剧审网字(2015)第0001号",
                    "huge_vthumb_url":"https:\/\/r1.ykimg.com\/0515000051D6667F6758397997070849",
                    "huge_thumb_url":"https:\/\/r1.ykimg.com\/0515000051D6667F6758397997070849",
                    "tags":"孙悟空",
                    "releasedate_youku":"1993-08-01 00:00:00",
                    "show_kind":"[\"PGC\",\"文化\"]",
                    "liveid":"[1111]",
                    "completed":false,
                    "play_state":"{\"big\":1,\"small\":0}",
                    "age_group":"[\"13到15岁\",\"16到17岁\"]",
                    "kids_age_max":99,
                    "kids_age_min":1,
                    "episode_last":6,
                    "update_notice":"每天24点更新",
                    "sub_title":"奋斗",
                    "guest_list":{
                        "person_outer_dto":[
                            {
                                "thumb_url":"http:\/\/r3.ykimg.com\/051300004E9F968697927334AC024BFD",
                                "name":"孙岳",
                                "id":1234,
                                "charactor":"小岳岳"
                            }
                        ]
                    },
                    "host_list":{
                        "person_outer_dto":[
                            {
                                "thumb_url":"http:\/\/r3.ykimg.com\/051300004E9F968697927334AC024BFD",
                                "name":"郭德刚",
                                "id":124,
                                "charactor":"刚子"
                            }
                        ]
                    },
                    "alias":{
                        "string":[
                            "[\"大话西游1\"",
                            "\"大话西游一\"",
                            "\"月光宝盒\"",
                            "\"大话西游\"]"
                        ]
                    },
                    "materials":{
                        "show_material_dto":[
                            {
                                "update_time":"http:\/\/r3.ykimg.com\/051300004E9F968697927334AC024BFD",
                                "url":"2018-08-01 00:00:00"
                            }
                        ]
                    },
                    "play_features":"{\"CIBN\":1024}",
                    "small_episode_last":23,
                    "small_update_notice":"每天24点更新",
                    "small_completed":false,
                    "download_status":""
                }
            }
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案
SHOW_UNAVAILABLE	节目不可用	下线该节目。
SYSTEM_ERROR	系统错误	请联系家庭娱乐媒资开发，并提供错误信息排查。

API测试工具错误码查询工具 SDK下载

开放平台

数娱媒资输出

taobao.vmac.full.show.get (大小屏节目信息单个获取接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ