文档中心 > API类目 > 门票-商品管理API

alitrip.ticket.rule.query (【门票API2.0】门票规则信息查询接口)

门票规则信息查询接口:返回商家上传的门票规则信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
out_rule_id String 必须 1234 卖家景点规则编码

响应参数

名称 类型 示例值 描述
first_result TicketRuleParam 门票规则信息
  • └ out_scenic_id
  • String
  • 1234
  • 商户景点编码
  • └ ali_scenic_id
  • Number
  • 1234
  • 阿里旅行景点编码
  • └ out_rule_id
  • String
  • 1234
  • 卖家景点规则编码
  • └ out_rule_name
  • String
  • 卖家景点规则名称
  • 卖家景点规则名称
  • └ rule_type
  • Number
  • 1
  • 票种规则类型(0实体票规则;1电子票规则)
  • └ rule_status
  • Number
  • 0
  • 规则状态(0:有效,-1:失效)
  • └ refund_type
  • Number
  • 1
  • 退票类型。1-无条件退改, 2-有条件退改, 3-不可退改。
  • └ refund_desc
  • String
  • 退票描述
  • 退票描述
  • └ visitor_require
  • Number
  • 1
  • 游客信息设置 1:不需要,2:仅需一位游客信息,3:需要所有游客信息
  • └ visitor_infos
  • String
  • 2,3,4
  • 需要的出游人信息,2:手机号,3:身份证,4:姓名,5:护照号码 6:护照姓名拼音。
  • └ visitor_limit_able
  • Number
  • 1
  • 出游人 是否限购。1:限购,2:不限购
  • └ visitor_limit_mode
  • Number
  • 1
  • 限购模式。mode为1按天, mode为2按周, mode为3按月
  • └ visitor_limit_num
  • Number
  • 1
  • 限购数量
  • └ enter_type
  • Number
  • 1
  • 入园类型。1-用兑换凭证直接入园,2-用兑换凭证换票入园
  • └ enter_voucher_type
  • Number
  • 1
  • 入园使用的凭证类型。1、二维码,2、身份证,3、二维码或身份证,4:数字码,5、手机号,6、其它
  • └ enter_voucher_value
  • String
  • 其他凭证
  • 其他入园凭证类型。
  • └ ticket_change_adderss
  • String
  • 换票地址
  • 换票地址
  • └ enter_address
  • String
  • 景区入园地址
  • 景区入园地址
  • └ fee_include
  • String
  • 门票费用包含
  • 门票费用包含
  • └ extra_desc
  • String
  • 补充说明
  • 补充说明
  • └ visitor_limit_type
  • Number
  • 0
  • 限购类型。0-身份证限购, 1-手机号限购

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTicketRuleQueryRequest req = new AlitripTicketRuleQueryRequest();
req.setOutRuleId("1234");
AlitripTicketRuleQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_ticket_rule_query_response>
    <first_result>
        <out_scenic_id>1234</out_scenic_id>
        <ali_scenic_id>1234</ali_scenic_id>
        <out_rule_id>1234</out_rule_id>
        <out_rule_name>卖家景点规则名称</out_rule_name>
        <rule_type>1</rule_type>
        <rule_status>0</rule_status>
        <refund_type>1</refund_type>
        <refund_desc>退票描述</refund_desc>
        <visitor_require>1</visitor_require>
        <visitor_infos>2,3,4</visitor_infos>
        <visitor_limit_able>1</visitor_limit_able>
        <visitor_limit_mode>1</visitor_limit_mode>
        <visitor_limit_num>1</visitor_limit_num>
        <enter_type>1</enter_type>
        <enter_voucher_type>1</enter_voucher_type>
        <enter_voucher_value>其他凭证</enter_voucher_value>
        <ticket_change_adderss>换票地址</ticket_change_adderss>
        <enter_address>景区入园地址</enter_address>
        <fee_include>门票费用包含</fee_include>
        <extra_desc>补充说明</extra_desc>
        <visitor_limit_type>0</visitor_limit_type>
    </first_result>
</alitrip_ticket_rule_query_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

拥有此API的权限组 可获得/可申请此API权限组的应用类型
门票-商品管理 飞猪-系统商   飞猪-度假  

FAQ

返回
顶部