阿里安全开放平台-阿里聚安全

请求地址：

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

名称	类型	是否必须	示例值	描述
ext_cinema_no	String	可选	0001	外部影院编号
partner_no	String	可选	lien	机具厂商
terminal_no	String	可选	TB00001	终端编号

名称	类型	示例值	描述
data	TerminalInfo		test
└ cinema_id Number 20010 影院id └ cloud Boolean false 是否云取票 └ ext_cinema_id String 10001 外部影院ID └ partner_code String dingxin 合作商编号 └ partner_id String taijiu 机具厂商 └ phone String 400-879-1755 客服联系电话 └ private_key String TAOBAO123 私钥 └ remote_address String 211.123.12.31 远程服务地址 └ remote_port String 8766 远程服务端口 sdk_features SdkFeature [] 机具功能 └ feature_code String 1 功能代码 └ sdk_owner String yueke 插件提供商 ticket_codes PartnerTerminalTemplate [] 配置集合 └ description String 输入8位取票码机具输入框中的文案信息 └ length Number 8 最大可输入字符数 └ name String 取票码界面名称 └ type String 0 纯数字 ticket_templates TicketTemplate [] 票纸模板列表 └ md5_code String ED903AEDB5C276F33AE60F63C6B24C41 模板文件的完整性校验md5码 └ type String film 模板类型：film-电影票，sale-卖品券，gift-赠品券 └ url String http://taobaodianying.alicdn.com/terminal/template/chongqing_film.xml 模板文件的下载地址 └ version Number 1 票纸模板版本号 └ user_name String TAOBAO 登陆用户名称 └ merge_partner String yueke 系统商代码 └ check_net Number 1 是否检查网络：1-是，0-否 └ tpp_phone String 0571-88157838 淘票票客服电话 └ member_tooltip_time String 5 memberTooltipTime └ need_remote_seek Number 1 1:表示需要云端查找验证码 0:表示不需要 sale_codes PartnerTerminalTemplate [] 卖品窗口配置集合 └ type String 0 纯数字 └ name String 取卖品码界面名称 └ length Number 8 最大可输入字符数 └ description String 输入8位取票码机具输入框中的文案信息 └ template_rule String 1 票版规则 └ template_extra String 1 定制票版
result_code	String	1001	返回码
result_desc	String	信息未配置	结果描述
status	Number	1	成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FilmTicketTerminalConfigGetRequest req = new FilmTicketTerminalConfigGetRequest();
req.setExtCinemaNo("0001");
req.setPartnerNo("lien");
req.setTerminalNo("TB00001");
FilmTicketTerminalConfigGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
FilmTicketTerminalConfigGetRequest req = new FilmTicketTerminalConfigGetRequest();
req.ExtCinemaNo = "0001";
req.PartnerNo = "lien";
req.TerminalNo = "TB00001";
FilmTicketTerminalConfigGetResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new FilmTicketTerminalConfigGetRequest;
$req->setExtCinemaNo("0001");
$req->setPartnerNo("lien");
$req->setTerminalNo("TB00001");
$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.ticket.terminal.config.get' \
-d 'partner_id=apidoc' \
-d 'sign=54A7976ECD6BEBE3BFC4199C9BD49F21' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-29+15%3A15%3A56' \
-d 'v=2.0' \
-d 'ext_cinema_no=0001' \
-d 'partner_no=lien' \
-d 'terminal_no=TB00001'

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

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

req.ext_cinema_no="0001"
req.partner_no="lien"
req.terminal_no="TB00001"
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.ticket.terminal.config.get");
add_param(pRequest,"ext_cinema_no","0001");
add_param(pRequest,"partner_no","lien");
add_param(pRequest,"terminal_no","TB00001");
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.ticket.terminal.config.get', {
	'ext_cinema_no':'0001',
	'partner_no':'lien',
	'terminal_no':'TB00001'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<film_ticket_terminal_config_get_response>
    <data>
        <cinema_id>20010</cinema_id>
        <cloud>false</cloud>
        <ext_cinema_id>10001</ext_cinema_id>
        <partner_code>dingxin</partner_code>
        <partner_id>taijiu</partner_id>
        <phone>400-879-1755</phone>
        <private_key>TAOBAO123</private_key>
        <remote_address>211.123.12.31</remote_address>
        <remote_port>8766</remote_port>
        <sdk_features>
            <sdk_feature>
                <feature_code>1</feature_code>
                <sdk_owner>yueke</sdk_owner>
            </sdk_feature>
        </sdk_features>
        <ticket_codes>
            <partner_terminal_template>
                <description>输入8位取票码</description>
                <length>8</length>
                <name>取票码</name>
                <type>0</type>
            </partner_terminal_template>
        </ticket_codes>
        <ticket_templates>
            <ticket_template>
                <md5_code>ED903AEDB5C276F33AE60F63C6B24C41</md5_code>
                <type>film</type>
                <url>http://taobaodianying.alicdn.com/terminal/template/chongqing_film.xml</url>
                <version>1</version>
            </ticket_template>
        </ticket_templates>
        <user_name>TAOBAO</user_name>
        <merge_partner>yueke</merge_partner>
        <check_net>1</check_net>
        <tpp_phone>0571-88157838</tpp_phone>
        <member_tooltip_time>5</member_tooltip_time>
        <need_remote_seek>1</need_remote_seek>
        <sale_codes>
            <partner_terminal_template>
                <type>0</type>
                <name>取卖品码</name>
                <length>8</length>
                <description>输入8位取票码</description>
            </partner_terminal_template>
        </sale_codes>
        <template_rule>1</template_rule>
        <template_extra>1</template_extra>
    </data>
    <result_code>1001</result_code>
    <result_desc>信息未配置</result_desc>
    <status>1</status>
</film_ticket_terminal_config_get_response>

{
    "film_ticket_terminal_config_get_response":{
        "data":{
            "cinema_id":20010,
            "cloud":false,
            "ext_cinema_id":"10001",
            "partner_code":"dingxin",
            "partner_id":"taijiu",
            "phone":"400-879-1755",
            "private_key":"TAOBAO123",
            "remote_address":"211.123.12.31",
            "remote_port":"8766",
            "sdk_features":{
                "sdk_feature":[
                    {
                        "feature_code":"1",
                        "sdk_owner":"yueke"
                    }
                ]
            },
            "ticket_codes":{
                "partner_terminal_template":[
                    {
                        "description":"输入8位取票码",
                        "length":8,
                        "name":"取票码",
                        "type":"0"
                    }
                ]
            },
            "ticket_templates":{
                "ticket_template":[
                    {
                        "md5_code":"ED903AEDB5C276F33AE60F63C6B24C41",
                        "type":"film",
                        "url":"http:\/\/taobaodianying.alicdn.com\/terminal\/template\/chongqing_film.xml",
                        "version":1
                    }
                ]
            },
            "user_name":"TAOBAO",
            "merge_partner":"yueke",
            "check_net":1,
            "tpp_phone":"0571-88157838",
            "member_tooltip_time":"5",
            "need_remote_seek":1,
            "sale_codes":{
                "partner_terminal_template":[
                    {
                        "type":"0",
                        "name":"取卖品码",
                        "length":8,
                        "description":"输入8位取票码"
                    }
                ]
            },
            "template_rule":"1",
            "template_extra":"1"
        },
        "result_code":"1001",
        "result_desc":"信息未配置",
        "status":1
    }
}

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.ticket.terminal.config.get (淘宝机具信息配置获取接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈