淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
benefit_policy_query_mtop_d_t_o	BenefitPolicyQueryMtopDto	必须			联名卡查询
└ approval_status String 可选 1 验证状态 └ total_page Number 可选 100 总页数 └ visibility_status String 可选 1 可用状态 └ cinema_link_id String 可选 110011 影院内码 └ benefit_policy_id String 可选 1123 联名卡id └ cur_page Number 可选 12 当前页 └ policy_name_like String 可选卖品卡政策名称 └ items_per_page Number 可选 10 每页商品数量 └ lease_code String 可选 hengda 租户编码 └ third_policy_flag String 可选 123 第三方联名卡标志 └ user_cinema_link_ids String 可选 110005，110006 用户影院内码集 └ items Number 可选 123 商品数 └ channel_code String 可选 pos 渠道编码 └ status String 可选 1 状态

名称	类型	示例值	描述
mtop_success	Boolean	true	success
data_list	DataList []		dataList
└ renew_days Number 3650 renewDays └ gmt_modified Date 1783410953000 gmtModified └ extension String 1 extension └ expired_date Date 1 expiredDate └ policy_from String CLOUD policyFrom └ remark String wycPreTest2 remark └ modify_user String 1 modifyUser └ approval_remark String 1 approvalRemark └ cur_version Number 1 curVersion └ channel_code String TAOBAO channelCode └ card_cost_fee Number 1000 cardCostFee └ approval_status String UNDER_APPROVAL approvalStatus └ available_cinema_name_list Json 1 availableCinemaNameList └ policy_name String 淘票票-wycPreTest2 policyName └ visibility_status String VISIBLE visibilityStatus └ available_cinema_link_id_set String [] availableCinemaLinkIdSet └ gmt_create Date 1783410953000 gmtCreate └ policy_limit String {"dailyTicketLimit":100,"scheduleTicketLimit":null,"totalTicketLimit":200,"renewTicketCount":200,"strategyList":[{"priority":1,"id":"pqxZxxXl","strategyName":"固定价格20","privilegeType":"FIXED_PRICE","privilegePlusValue":null,"privilegeMultiplyValue":null,"privilegeFixedValue":2000,"allowBreakLowestPrice":"Y","conditionList":[{"conditionType":"WEEK_TIME","weekDateTimeSet":[{"startDate":null,"endDate":null,"startTime":"00:00","endTime":"23:59","weekDaySet":null,"weekTimeSet":null}],"weekTimeSet":null},{"conditionType":"FILM_VERSION","filmVersionSet":["2DDMAX","3DDMAX","2DNORMAL","3DNORMAL","4DNORMAL","3DIMAX","2DIMAX"]},{"conditionType":"CINEMA_HALL","cinemaSet":[{"cinemaLinkId":"888","hallIdSet":null}]}]}]} policyLimit └ benefit_policy_goods_list Json 1 benefitPolicyGoodsList └ renew_amount Number 1000 renewAmount └ third_policy_info_entity Json 1 thirdPolicyInfoEntity └ benefit_policy_id Number 610653 benefitPolicyId available_cinema_link_id_map AvailableCinemaLinkIdMap availableCinemaLinkIdMap └ 888 String [] 888 └ policy_type String TICKET_GOODS_DISCOUNT policyType └ lease_code String dsf leaseCode └ third_policy_flag String N thirdPolicyFlag └ third_policy_info String 1 thirdPolicyInfo └ channel_name String 1 channelName └ create_user String dsfadmin createUser └ valid_days Number 3650 validDays └ available_cinema_name_map Json 1 availableCinemaNameMap └ status String DISABLED status
page_info	PageInfo		pageInfo
└ cur_page Number 1 curPage └ total_page Number 1 totalPage └ items_per_page Number 100 itemsPerPage └ items Number 5 items
result_code	String	1	resultCode
result_msg	String	1	resultMsg

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LarkBenefitcardPolicyGetlistRequest req = new LarkBenefitcardPolicyGetlistRequest();
LarkBenefitcardPolicyGetlistRequest.BenefitPolicyQueryMtopDto obj1 = new LarkBenefitcardPolicyGetlistRequest.BenefitPolicyQueryMtopDto();
obj1.setApprovalStatus("1");
obj1.setTotalPage(100L);
obj1.setVisibilityStatus("1");
obj1.setCinemaLinkId("110011");
obj1.setBenefitPolicyId("1123");
obj1.setCurPage(12L);
obj1.setPolicyNameLike("卖品卡");
obj1.setItemsPerPage(10L);
obj1.setLeaseCode("hengda");
obj1.setThirdPolicyFlag("123");
obj1.setUserCinemaLinkIds("110005，110006");
obj1.setItems(123L);
obj1.setChannelCode("pos");
obj1.setStatus("1");
req.setBenefitPolicyQueryMtopDTO(obj1);
LarkBenefitcardPolicyGetlistResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
LarkBenefitcardPolicyGetlistRequest req = new LarkBenefitcardPolicyGetlistRequest();
LarkBenefitcardPolicyGetlistRequest.BenefitPolicyQueryMtopDtoDomain obj1 = new LarkBenefitcardPolicyGetlistRequest.BenefitPolicyQueryMtopDtoDomain();
obj1.ApprovalStatus = "1";
obj1.TotalPage = 100L;
obj1.VisibilityStatus = "1";
obj1.CinemaLinkId = "110011";
obj1.BenefitPolicyId = "1123";
obj1.CurPage = 12L;
obj1.PolicyNameLike = "卖品卡";
obj1.ItemsPerPage = 10L;
obj1.LeaseCode = "hengda";
obj1.ThirdPolicyFlag = "123";
obj1.UserCinemaLinkIds = "110005，110006";
obj1.Items = 123L;
obj1.ChannelCode = "pos";
obj1.Status = "1";
req.BenefitPolicyQueryMtopDTO_ = obj1;
LarkBenefitcardPolicyGetlistResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new LarkBenefitcardPolicyGetlistRequest;
$benefit_policy_query_mtop_d_t_o = new BenefitPolicyQueryMtopDto;
$benefit_policy_query_mtop_d_t_o->approval_status="1";
$benefit_policy_query_mtop_d_t_o->total_page="100";
$benefit_policy_query_mtop_d_t_o->visibility_status="1";
$benefit_policy_query_mtop_d_t_o->cinema_link_id="110011";
$benefit_policy_query_mtop_d_t_o->benefit_policy_id="1123";
$benefit_policy_query_mtop_d_t_o->cur_page="12";
$benefit_policy_query_mtop_d_t_o->policy_name_like="卖品卡";
$benefit_policy_query_mtop_d_t_o->items_per_page="10";
$benefit_policy_query_mtop_d_t_o->lease_code="hengda";
$benefit_policy_query_mtop_d_t_o->third_policy_flag="123";
$benefit_policy_query_mtop_d_t_o->user_cinema_link_ids="110005，110006";
$benefit_policy_query_mtop_d_t_o->items="123";
$benefit_policy_query_mtop_d_t_o->channel_code="pos";
$benefit_policy_query_mtop_d_t_o->status="1";
$req->setBenefitPolicyQueryMtopDTO(json_encode($benefit_policy_query_mtop_d_t_o));
$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.lark.benefitcard.policy.getlist' \
-d 'partner_id=apidoc' \
-d 'sign=7EABA6FB96486B64B5ECD47DA9ED849F' \
-d 'sign_method=hmac' \
-d 'timestamp=2026-10-08+04%3A53%3A01' \
-d 'v=2.0' \
-d 'benefit_policy_query_mtop_d_t_o=null'

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

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

req.benefit_policy_query_mtop_d_t_o=""
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.lark.benefitcard.policy.getlist");
add_param(pRequest,"benefit_policy_query_mtop_d_t_o","数据结构JSON示例");
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',
	'url': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.lark.benefitcard.policy.getlist', {
	'benefit_policy_query_mtop_d_t_o':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<lark_benefitcard_policy_getlist_response>
    <mtop_success>true</mtop_success>
    <data_list>
        <data_list>
            <renew_days>3650</renew_days>
            <gmt_modified>1783410953000</gmt_modified>
            <extension>1</extension>
            <expired_date>1</expired_date>
            <policy_from>CLOUD</policy_from>
            <remark>wycPreTest2</remark>
            <modify_user>1</modify_user>
            <approval_remark>1</approval_remark>
            <cur_version>1</cur_version>
            <channel_code>TAOBAO</channel_code>
            <card_cost_fee>1000</card_cost_fee>
            <approval_status>UNDER_APPROVAL</approval_status>
            <available_cinema_name_list>1</available_cinema_name_list>
            <policy_name>淘票票-wycPreTest2</policy_name>
            <visibility_status>VISIBLE</visibility_status>
            <gmt_create>1783410953000</gmt_create>
            <policy_limit>{&quot;dailyTicketLimit&quot;:100,&quot;scheduleTicketLimit&quot;:null,&quot;totalTicketLimit&quot;:200,&quot;renewTicketCount&quot;:200,&quot;strategyList&quot;:[{&quot;priority&quot;:1,&quot;id&quot;:&quot;pqxZxxXl&quot;,&quot;strategyName&quot;:&quot;固定价格20&quot;,&quot;privilegeType&quot;:&quot;FIXED_PRICE&quot;,&quot;privilegePlusValue&quot;:null,&quot;privilegeMultiplyValue&quot;:null,&quot;privilegeFixedValue&quot;:2000,&quot;allowBreakLowestPrice&quot;:&quot;Y&quot;,&quot;conditionList&quot;:[{&quot;conditionType&quot;:&quot;WEEK_TIME&quot;,&quot;weekDateTimeSet&quot;:[{&quot;startDate&quot;:null,&quot;endDate&quot;:null,&quot;startTime&quot;:&quot;00:00&quot;,&quot;endTime&quot;:&quot;23:59&quot;,&quot;weekDaySet&quot;:null,&quot;weekTimeSet&quot;:null}],&quot;weekTimeSet&quot;:null},{&quot;conditionType&quot;:&quot;FILM_VERSION&quot;,&quot;filmVersionSet&quot;:[&quot;2DDMAX&quot;,&quot;3DDMAX&quot;,&quot;2DNORMAL&quot;,&quot;3DNORMAL&quot;,&quot;4DNORMAL&quot;,&quot;3DIMAX&quot;,&quot;2DIMAX&quot;]},{&quot;conditionType&quot;:&quot;CINEMA_HALL&quot;,&quot;cinemaSet&quot;:[{&quot;cinemaLinkId&quot;:&quot;888&quot;,&quot;hallIdSet&quot;:null}]}]}]}</policy_limit>
            <benefit_policy_goods_list>1</benefit_policy_goods_list>
            <renew_amount>1000</renew_amount>
            <third_policy_info_entity>1</third_policy_info_entity>
            <benefit_policy_id>610653</benefit_policy_id>
            <available_cinema_link_id_map>
            </available_cinema_link_id_map>
            <policy_type>TICKET_GOODS_DISCOUNT</policy_type>
            <lease_code>dsf</lease_code>
            <third_policy_flag>N</third_policy_flag>
            <third_policy_info>1</third_policy_info>
            <channel_name>1</channel_name>
            <create_user>dsfadmin</create_user>
            <valid_days>3650</valid_days>
            <available_cinema_name_map>1</available_cinema_name_map>
            <status>DISABLED</status>
        </data_list>
    </data_list>
    <page_info>
        <cur_page>1</cur_page>
        <total_page>1</total_page>
        <items_per_page>100</items_per_page>
        <items>5</items>
    </page_info>
    <result_code>1</result_code>
    <result_msg>1</result_msg>
</lark_benefitcard_policy_getlist_response>

{
    "lark_benefitcard_policy_getlist_response":{
        "mtop_success":true,
        "data_list":{
            "data_list":[
                {
                    "renew_days":3650,
                    "gmt_modified":"1783410953000",
                    "extension":"1",
                    "expired_date":"1",
                    "policy_from":"CLOUD",
                    "remark":"wycPreTest2",
                    "modify_user":"1",
                    "approval_remark":"1",
                    "cur_version":1,
                    "channel_code":"TAOBAO",
                    "card_cost_fee":1000,
                    "approval_status":"UNDER_APPROVAL",
                    "available_cinema_name_list":"1",
                    "policy_name":"淘票票-wycPreTest2",
                    "visibility_status":"VISIBLE",
                    "gmt_create":"1783410953000",
                    "policy_limit":"{\"dailyTicketLimit\":100,\"scheduleTicketLimit\":null,\"totalTicketLimit\":200,\"renewTicketCount\":200,\"strategyList\":[{\"priority\":1,\"id\":\"pqxZxxXl\",\"strategyName\":\"固定价格20\",\"privilegeType\":\"FIXED_PRICE\",\"privilegePlusValue\":null,\"privilegeMultiplyValue\":null,\"privilegeFixedValue\":2000,\"allowBreakLowestPrice\":\"Y\",\"conditionList\":[{\"conditionType\":\"WEEK_TIME\",\"weekDateTimeSet\":[{\"startDate\":null,\"endDate\":null,\"startTime\":\"00:00\",\"endTime\":\"23:59\",\"weekDaySet\":null,\"weekTimeSet\":null}],\"weekTimeSet\":null},{\"conditionType\":\"FILM_VERSION\",\"filmVersionSet\":[\"2DDMAX\",\"3DDMAX\",\"2DNORMAL\",\"3DNORMAL\",\"4DNORMAL\",\"3DIMAX\",\"2DIMAX\"]},{\"conditionType\":\"CINEMA_HALL\",\"cinemaSet\":[{\"cinemaLinkId\":\"888\",\"hallIdSet\":null}]}]}]}",
                    "benefit_policy_goods_list":"1",
                    "renew_amount":1000,
                    "third_policy_info_entity":"1",
                    "benefit_policy_id":610653,
                    "available_cinema_link_id_map":{
                    },
                    "policy_type":"TICKET_GOODS_DISCOUNT",
                    "lease_code":"dsf",
                    "third_policy_flag":"N",
                    "third_policy_info":"1",
                    "channel_name":"1",
                    "create_user":"dsfadmin",
                    "valid_days":3650,
                    "available_cinema_name_map":"1",
                    "status":"DISABLED"
                }
            ]
        },
        "page_info":{
            "cur_page":1,
            "total_page":1,
            "items_per_page":100,
            "items":5
        },
        "result_code":"1",
        "result_msg":"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.lark.benefitcard.policy.getlist (获取联名卡政策)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ