淘宝开放平台 - 文档中心

请求地址：

环境	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 是否完结 └ episode_last Number 6 最新集数 └ production String 河北电影电视剧制作中心、太原电视台制作公司 └ distributor String 20世纪福克斯电影公司、环球影业发行公司 guest_list Person [] -- 嘉宾列表 └ charactor String [] ["凯凯"] 描述 └ thumb_url String http://r3.ykimg.com/051300004E9F968697927334AC024BFD 人物图片 └ name String 王凯人物名 └ id Number id id └ program_id Number 1111 program id └ sub_title String 三生爱恨牵引三世纠葛节目子标题 └ update_notice String 每天24点更新更新提示 └ zreal Boolean false 是否是帧享 └ permit_duration Number 2 消费期(收费节目)(天) └ showseq Number 节目在所属系列中的序号 1 └ series String 所属系列名称哈皮父子 host_list PersonOuterDto [] -- 主持人列表 └ id Number 111 id └ name String 王凯人物名 └ thumb_url String http://r3.ykimg.com/051300004E9F968697927334AC024BFD 人物图片 └ hugeshow_w3_h4_thumb_url String https://cn-vmc-images.alicdn.com/vmac/1000000005274000596C2FB6ADBDD3B9C10EA58B 3:4大竖图 └ show_w3_h4_thumb_url String http://cn-vmc-images.alicdn.com/vmac/1000000005264000596C2FB6ADBDD3B9C10EA58B 3:4竖图 └ show_feature_list String [] z_real 节目特性。z_real：表示是帧享节目 └ hfr_list String [] 60p 帧享的帧率信息。60p：60帧 120p:120帧

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

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

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

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new VmacShowGetRequest;
$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.show.get' \
-d 'partner_id=apidoc' \
-d 'sign=2094AE89519F29DCF879AF628B1EA85F' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-04+16%3A27%3A01' \
-d 'v=2.0' \
-d 'show_id=jowekrj'

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

req=top.api.VmacShowGetRequest(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.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.show.get', {
	'show_id':'jowekrj'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<vmac_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>
                            <string>[&quot;至尊宝&quot;]</string>
                        </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>
                            <string>[&quot;至尊宝&quot;]</string>
                        </charactor>
                        <name>周星驰</name>
                        <thumb_url>http://r3.ykimg.com/051300004E9F968697927334AC024BFD</thumb_url>
                        <id>1234</id>
                    </person>
                </performer_list>
                <starring_list>
                    <person>
                        <charactor>
                            <string>[&quot;至尊宝&quot;]</string>
                        </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>
                <episode_last>6</episode_last>
                <production>河北电影电视剧制作中心、太原电视台</production>
                <distributor>20世纪福克斯电影公司、环球影业</distributor>
                <guest_list>
                    <person>
                        <charactor>
                            <string>[&quot;凯凯&quot;]</string>
                        </charactor>
                        <thumb_url>http://r3.ykimg.com/051300004E9F968697927334AC024BFD</thumb_url>
                        <name>王凯</name>
                        <id>id</id>
                    </person>
                </guest_list>
                <program_id>1111</program_id>
                <sub_title>三生爱恨牵引三世纠葛</sub_title>
                <update_notice>每天24点更新</update_notice>
                <zreal>false</zreal>
                <permit_duration>2</permit_duration>
                <showseq>节目在所属系列中的序号</showseq>
                <series>所属系列名称</series>
                <host_list>
                    <person_outer_dto>
                        <id>111</id>
                        <name>王凯</name>
                        <thumb_url>http://r3.ykimg.com/051300004E9F968697927334AC024BFD</thumb_url>
                    </person_outer_dto>
                </host_list>
                <hugeshow_w3_h4_thumb_url>https://cn-vmc-images.alicdn.com/vmac/1000000005274000596C2FB6ADBDD3B9C10EA58B</hugeshow_w3_h4_thumb_url>
                <show_w3_h4_thumb_url>http://cn-vmc-images.alicdn.com/vmac/1000000005264000596C2FB6ADBDD3B9C10EA58B</show_w3_h4_thumb_url>
                <show_feature_list>
                    <string>z_real</string>
                </show_feature_list>
                <hfr_list>
                    <string>60p</string>
                </hfr_list>
            </show>
        </value>
    </result>
</vmac_show_get_response>

{
    "vmac_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":{
                                    "string":[
                                        "[\"至尊宝\"]"
                                    ]
                                },
                                "name":"刘镇伟",
                                "thumb_url":"http:\/\/r4.ykimg.com\/05130000579EB81967BC3C0ABE0C57C1",
                                "id":1234
                            }
                        ]
                    },
                    "license_list":{
                        "string":[
                            "CIBN"
                        ]
                    },
                    "performer_list":{
                        "person":[
                            {
                                "charactor":{
                                    "string":[
                                        "[\"至尊宝\"]"
                                    ]
                                },
                                "name":"周星驰",
                                "thumb_url":"http:\/\/r3.ykimg.com\/051300004E9F968697927334AC024BFD",
                                "id":1234
                            }
                        ]
                    },
                    "starring_list":{
                        "person":[
                            {
                                "charactor":{
                                    "string":[
                                        "[\"至尊宝\"]"
                                    ]
                                },
                                "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,
                    "episode_last":6,
                    "production":"河北电影电视剧制作中心、太原电视台",
                    "distributor":"20世纪福克斯电影公司、环球影业",
                    "guest_list":{
                        "person":[
                            {
                                "charactor":{
                                    "string":[
                                        "[\"凯凯\"]"
                                    ]
                                },
                                "thumb_url":"http:\/\/r3.ykimg.com\/051300004E9F968697927334AC024BFD",
                                "name":"王凯",
                                "id":id
                            }
                        ]
                    },
                    "program_id":1111,
                    "sub_title":"三生爱恨牵引三世纠葛",
                    "update_notice":"每天24点更新",
                    "zreal":false,
                    "permit_duration":2,
                    "showseq":节目在所属系列中的序号,
                    "series":"所属系列名称",
                    "host_list":{
                        "person_outer_dto":[
                            {
                                "id":111,
                                "name":"王凯",
                                "thumb_url":"http:\/\/r3.ykimg.com\/051300004E9F968697927334AC024BFD"
                            }
                        ]
                    },
                    "hugeshow_w3_h4_thumb_url":"https:\/\/cn-vmc-images.alicdn.com\/vmac\/1000000005274000596C2FB6ADBDD3B9C10EA58B",
                    "show_w3_h4_thumb_url":"http:\/\/cn-vmc-images.alicdn.com\/vmac\/1000000005264000596C2FB6ADBDD3B9C10EA58B",
                    "show_feature_list":{
                        "string":[
                            "z_real"
                        ]
                    },
                    "hfr_list":{
                        "string":[
                            "60p"
                        ]
                    }
                }
            }
        }
    }
}

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.show.get (获取媒资节目信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ