马蜂窝开放平台

获取产品列表信息

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

请求URL

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

请求Action

action：sales.product.list.get

请求参数

参数名称	参数类型	必填	示例	描述
page_no	int	是	1	当前页数
page_size	int	否	20	单页条数（最大值20）超过20也只会返回20条
sales_status	int	否	1	产品状态，主要包括：0-未上线，1-已上线，2-人工下线，3-系统下线，4-审核下线；不传此参数默认返回全部
exclude_aggregate	int	否	0	是否根据出发地展开成多个商品，0-展开，1-不展开

响应参数

参数名称	参数类型	示例	描述
list	array	[]
{}	object	0
└ sales_id	int	2253460	产品id
└ spu_id	int	2253460	SPU id
└ sales_name	string	一日游	产品名称
└ sales_type	int	11	品类id（二级品类）
└ sales_type_name	string	景区/场馆	品类名称（二级品类）
└ sales_status	int	1	产品状态，主要包括：0-未上线，1-已上线，2-人工下线，3-系统下线，4-审核下线；
└ img_top	string	https://b2-q.mafengwo.net/path/file.jpeg	产品头图地址
sku_list	array	[]	产品关联的sku信息
{}	object	0
└ sku_id	int	248862	马蜂窝sku_id
└ ota_sku_id	string	S121455	商家在马蜂窝商家后台设置的SKU外部编码
└ sku_name	string	门票+电子导览	sku名称
└ range_clean_day	int	1	提前预订天数，与提前预订时间配合使用；
└ range_clean_time	time	10:00:00	提前预订时间，如range_clean_day＝0，range_clean_time＝10:00:00，表示当天10点前SKU可订
total	int	123	总数

响应示例

{
    "list":[
        {
            "sales_id":"2253460",
            "spu_id":"2253460",
            "sales_name":"一日游",
            "sales_type":"11",
            "sales_type_name":"景区/场馆",
            "sales_status":"1",
            "img_top":"https://b2-q.mafengwo.net/path/file.jpeg",
            "sku_list":[
                {
                    "sku_id":"248862",
                    "ota_sku_id":"S121455",
                    "sku_name":"门票+电子导览",
                    "range_clean_day":"1",
                    "range_clean_time":"10:00:00"
                }
            ]
        }
    ],
    "total":"123"
}

异常错误码

异常码	异常信息
10100001	[sale_status]不在指定的状态范围内