马蜂窝开放平台

门票规则信息获取接口

通过该接口获取门票规则信息包括了预定须知信息和绑定的poi及票型信息

调用频次

此接口调用频次上限默认为30次/分钟，如不能满足业务需要请添加马蜂窝开放平台交流群：201650204 申请调整。

请求URL

正式环境：https://openapi.mafengwo.cn/deals/rest

请求Action

action：sales.ticket.sku.rule.get

请求参数

参数名称	参数类型	必填	示例	描述
sku_id	int	是	12343	马蜂窝sku_id

响应参数

参数名称	参数类型	示例	描述
sku_id	int	12341	马蜂窝sku_id
cost_include	string	一切门票费用	费用包含
cost_exclude	string	一切个人消费及费用包含中未提及的任何费用。	费用不含
effective_type	int	1	生效时间类型: 0是立即生效 ,1是出票后xx分钟生效 ,默认 0
effective_time	int	20	生效时间
expiry_type	int	1	有效期类型 0-相对有效期，1-绝对有效期
expiry_day	int	1	单位：天有限期类型为：“1-相对有效期”时，必填；填1表示指定出行日期1天内有效；
expiry_date	date	2019-11-11	有限期类型为：“2-绝对有效期”时，必填；表示指定出行日期至所填日期有效
purch_limit_id_info	object	{}	身份证限购信息 eg:同一身份证{limit_day}天内,最多可购买{num}{unit}
└ limit_day	int	0	限制天数
└ num	int	1	限购数
└ unit	int	0	限购数单位 0 张 1 次默认0
purch_limit_phone_info	object	{}	手机号限购信息
└ limit_day	int	1	限制天数
└ num	int	1	限购数
└ unit	int	0	限购数单位 0张 1次默认 0
entrance_mode	array	[]	入园方式
{}	object	0
└ mode_id	int	1	入园方式标识ID: 1-身份证 2-商家电子码 4-二维码 8-商家出行确认单 16-商家邮件 32-商家短信 64-实体票 128-护照 256-港澳通信证 512-台湾通行证
entrance_mode_type	int	1	入园方式是“或”还是“和”的关系 0:或 1:和
exchange_time_start	time	11:00:00	换票开始时间【开始时间大于结束时间时，则表示可跨天换票】
exchange_time_end	time	12:00:00	换票结束时间【开始时间大于结束时间时，则表示可跨天换票】
exchange_place	string	售票窗口	换票地点
ext_note	string	补充说明	补充说明补充说明最多500字
invoice_note	string	发票说明	发票说明发票说明最多64字
poi_item_info	array	[]	poi 票型信息
{}	object	0
└ poi_id	int	12345	马蜂窝POI_ID
└ item_id	int	12234	票型ID

响应示例

{
    "sku_id":"12341",
    "cost_include":"一切门票费用",
    "cost_exclude":"一切个人消费及费用包含中未提及的任何费用。",
    "effective_type":"1",
    "effective_time":"20",
    "expiry_type":"1",
    "expiry_day":"1",
    "expiry_date":"2019-11-11",
    "purch_limit_id_info":{
        "limit_day":"0",
        "num":"1",
        "unit":"0"
    },
    "purch_limit_phone_info":{
        "limit_day":"1",
        "num":"1",
        "unit":"0"
    },
    "entrance_mode":[
        {
            "mode_id":"1"
        }
    ],
    "entrance_mode_type":"1",
    "exchange_time_start":"11:00:00",
    "exchange_time_end":"12:00:00",
    "exchange_place":"售票窗口",
    "ext_note":"补充说明",
    "invoice_note":"发票说明",
    "poi_item_info":[
        {
            "poi_id":"12345",
            "item_id":"12234"
        }
    ]
}

异常错误码

异常码	异常信息
10060059	没有该库存操作权限
10060050	SKU不存在
10060048	参数不全