淘宝开放平台 - 文档中心

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
platform	Number	必须	123		平台
city_code	Number	可选	310100		城市码

名称	类型	示例值	描述
result	GetSoonShowsResult		即将上映影片信息同步给微博
└ result_code String demo 返回码 └ result_msg String demo 返回信息 soon_shows Show [] 影片列表 └ accumulative_sales String demo 累计票房(万元) └ available_cinema_count Number 123 可看影片数目 └ available_schedule_count Number 123 可看排期数目 └ available_today_schedule_count Number 123 今日可看排期数目 └ background_picture String demo 背景图片 └ background_video String demo 背景视频 └ cinema_count Number 123 影片有多少影院在上映该片 └ comment String demo 评论 └ country String demo 国家 └ custom_poster String demo 定制海报 └ description String demo 简介 └ director String demo 导演 └ distributor String demo 发行商 └ duration Number 123 片长（分钟） └ edit_time Date 2015-08-11 14:57:14 视频更新时间 └ flag Number 123 影片标：热门影片 └ highlight String demo 精彩点评 └ id Number 1001 影片id └ imdbid String demo 国际标准影片id号 └ is_attention Boolean false isAttention └ is_remind Boolean false 是否标记为上映提醒 └ is_want Boolean false 是否标记为想看 └ language String demo 对白语言 └ leading_role String demo 主演 └ low_price Number 123 影片兑换券对应的最低价格。单位 “分” └ max_seat_price Number 123 最高座位价格 └ min_seat_price Number 123 最低座位价格 └ open_day Date 2015-08-11 14:57:15 首映日期格式：YYYY-MM-DD └ order_by Number 123 排序 └ order_count Number 123 影片订单数 └ platform Number 123 不显示的平台 └ poster String demo 海报 └ price Number 123 额外记录影片价格,一般来源于场次。单位 “分” └ recent_order_amount Number 123 影片最近7天销售金额(分) └ remark String demo 评分 └ schedule_count Number 123 上映该影片的场次数 └ show_mark String demo （IMAX 3D>巨幕3D>IMAX>巨幕>4D>3D） └ show_name String 霍比特人影片名称 └ show_name_en String demo 电影英文名 └ show_version_list String [] ["hello","world"] 影片版本，例：2D └ support_type String demo 支持类型。（在线选座等） └ trailer_list String [] ["hello","world"] 剧照，最多100张 └ type String demo 类型 └ view_count Number 123 浏览pv └ want_count Number 123 想看数 └ week_sales String demo 周票房(万元) └ worth_pct String demo 值得看百分比,如78% └ pre_schedule_dates String [] 1456789765 preScheduleDates └ success Boolean false 是否成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FilmSoonshowsGetRequest req = new FilmSoonshowsGetRequest();
req.setPlatform(123L);
req.setCityCode(310100L);
FilmSoonshowsGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
FilmSoonshowsGetRequest req = new FilmSoonshowsGetRequest();
req.Platform = 123L;
req.CityCode = 310100L;
FilmSoonshowsGetResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new FilmSoonshowsGetRequest;
$req->setPlatform("123");
$req->setCityCode("310100");
$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.film.soonshows.get' \
-d 'partner_id=apidoc' \
-d 'sign=8AAFA898D71F25BBB78637CA0D5F8CD3' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-10-25+16%3A25%3A33' \
-d 'v=2.0' \
-d 'city_code=310100' \
-d 'platform=123'

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

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

req.platform=123
req.city_code=310100
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.film.soonshows.get");
add_param(pRequest,"platform","123");
add_param(pRequest,"city_code","310100");
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.film.soonshows.get', {
	'platform':'123',
	'city_code':'310100'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<film_soonshows_get_response>
    <result>
        <result_code>demo</result_code>
        <result_msg>demo</result_msg>
        <soon_shows>
            <show>
                <accumulative_sales>demo</accumulative_sales>
                <available_cinema_count>123</available_cinema_count>
                <available_schedule_count>123</available_schedule_count>
                <available_today_schedule_count>123</available_today_schedule_count>
                <background_picture>demo</background_picture>
                <background_video>demo</background_video>
                <cinema_count>123</cinema_count>
                <comment>demo</comment>
                <country>demo</country>
                <custom_poster>demo</custom_poster>
                <description>demo</description>
                <director>demo</director>
                <distributor>demo</distributor>
                <duration>123</duration>
                <edit_time>2015-08-11 14:57:14</edit_time>
                <flag>123</flag>
                <highlight>demo</highlight>
                <id>1001</id>
                <imdbid>demo</imdbid>
                <is_attention>false</is_attention>
                <is_remind>false</is_remind>
                <is_want>false</is_want>
                <language>demo</language>
                <leading_role>demo</leading_role>
                <low_price>123</low_price>
                <max_seat_price>123</max_seat_price>
                <min_seat_price>123</min_seat_price>
                <open_day>2015-08-11 14:57:15</open_day>
                <order_by>123</order_by>
                <order_count>123</order_count>
                <platform>123</platform>
                <poster>demo</poster>
                <price>123</price>
                <recent_order_amount>123</recent_order_amount>
                <remark>demo</remark>
                <schedule_count>123</schedule_count>
                <show_mark>demo</show_mark>
                <show_name>霍比特人</show_name>
                <show_name_en>demo</show_name_en>
                <show_version_list>
                    <string>[&quot;hello&quot;</string>
                    <string>&quot;world&quot;]</string>
                </show_version_list>
                <support_type>demo</support_type>
                <trailer_list>
                    <string>[&quot;hello&quot;</string>
                    <string>&quot;world&quot;]</string>
                </trailer_list>
                <type>demo</type>
                <view_count>123</view_count>
                <want_count>123</want_count>
                <week_sales>demo</week_sales>
                <worth_pct>demo</worth_pct>
                <pre_schedule_dates>
                    <string>1456789765</string>
                </pre_schedule_dates>
            </show>
        </soon_shows>
        <success>false</success>
    </result>
</film_soonshows_get_response>

{
    "film_soonshows_get_response":{
        "result":{
            "result_code":"demo",
            "result_msg":"demo",
            "soon_shows":{
                "show":[
                    {
                        "accumulative_sales":"demo",
                        "available_cinema_count":123,
                        "available_schedule_count":123,
                        "available_today_schedule_count":123,
                        "background_picture":"demo",
                        "background_video":"demo",
                        "cinema_count":123,
                        "comment":"demo",
                        "country":"demo",
                        "custom_poster":"demo",
                        "description":"demo",
                        "director":"demo",
                        "distributor":"demo",
                        "duration":123,
                        "edit_time":"2015-08-11 14:57:14",
                        "flag":123,
                        "highlight":"demo",
                        "id":1001,
                        "imdbid":"demo",
                        "is_attention":false,
                        "is_remind":false,
                        "is_want":false,
                        "language":"demo",
                        "leading_role":"demo",
                        "low_price":123,
                        "max_seat_price":123,
                        "min_seat_price":123,
                        "open_day":"2015-08-11 14:57:15",
                        "order_by":123,
                        "order_count":123,
                        "platform":123,
                        "poster":"demo",
                        "price":123,
                        "recent_order_amount":123,
                        "remark":"demo",
                        "schedule_count":123,
                        "show_mark":"demo",
                        "show_name":"霍比特人",
                        "show_name_en":"demo",
                        "show_version_list":{
                            "string":[
                                "[\"hello\"",
                                "\"world\"]"
                            ]
                        },
                        "support_type":"demo",
                        "trailer_list":{
                            "string":[
                                "[\"hello\"",
                                "\"world\"]"
                            ]
                        },
                        "type":"demo",
                        "view_count":123,
                        "want_count":123,
                        "week_sales":"demo",
                        "worth_pct":"demo",
                        "pre_schedule_dates":{
                            "string":[
                                "1456789765"
                            ]
                        }
                    }
                ]
            },
            "success":false
        }
    }
}

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"
	}
}

错误码	错误描述	解决方案

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

开放平台

电影票API

taobao.film.soonshows.get (即将上映影片查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ