优惠

获取优惠分类

TIP

获取该商场下优惠分类列表

接口地址：https://openapi10.mallcoo.cn/Event/Promotion/V1/GetCategoryList/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

接口调用参数

名称	数据类型	必填	说明
ParentID	long	否	父级ID（不填时默认查询一级分类，查询二级分类时需传入对应的父级ID）

参数示例

{ 
  "ParentID": 1
}

返回结果

名称	数据类型	必填	说明
Code	int	是	状态码
Data	Json	是	返回数据
Message	string	是	返回状态描述

Data

名称	数据类型	必填	说明
PromotionCategoryID	long	是	优惠分类ID
Name	string	是	分类名称
TypeIcon	string	是	图片

返回示例

{
  "Code": 1,
  "Data": 
  [
      {
        "PromotionCategoryID": 1,
        "Name": "麦霸优惠",
        "TypeIcon": "http://i1.mallcoo.cn/sp_mall/82de37a0-db14-4c23-aca9.jpg",
      },
  ],
  "Message": "成功"
}

获取优惠列表

TIP

仅获取该商场下优惠列表信息

接口地址：https://openapi10.mallcoo.cn/Event/Promotion/V1/GetList/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

接口调用参数

名称	数据类型	必填	说明
PromotionCategoryID	long	否	优惠一级分类ID
PromotionSubCategoryID	long	否	优惠二级分类ID
State	Enum	否	状态（1:即将开始，2:进行中，3:已结束）
PageSize	int	否	每页数量（默认10）
PageIndex	int	否	当前页码（默认1）

参数示例

{
  "PromotionCategoryID": 1,
  "PromotionSubCategoryID": null,
  "State": 1,
  "PageIndex": 1,
  "PageSize": 10,
}

返回结果

名称	数据类型	必填	说明
Code	int	是	状态码
Data	Json	是	返回数据
Message	string	是	返回状态描述

Data

名称	数据类型	必填	说明
PromotionID	long	是	优惠ID
Name	string	是	名称
SubTitle	string	否	副标题
Photo	string	是	头图
State	Enum	是	状态（1:即将开始，2:进行中，3:已结束）
StartTime	DateTime	是	开始时间
EndTime	DateTime	是	结束时间
PromotionCategoryID	long	否	优惠一级分类ID
PromotionSubCategoryID	long	否	优惠二级分类ID
Rank	string	否	权重
CreateTime	DateTime	否	创建时间

返回示例

{
  "Code": 1,
  "Data": 
  [
      {
        "PromotionID": 274,
        "Name": "8.25优惠",
        "SubTitle": "",
        "StartTime": "2016-08-25 00:00:00",
        "EndTime": "2016-08-31 00:00:00",
        "Photo": "http://i1.mallcoo.cn/sp_mall/82de37a0-db14-4c23-aca9-589007.jpg",
        "State": 3,
        "PromotionCategoryID": 1,
        "PromotionSubCategoryID": null,
        "Rank":8888,
        "CreateTime":"2016-08-25 00:00:00",
      },
  ],
  "Message": "成功"
}

获取优惠详情

TIP

获取该优惠详情信息

接口地址：https://openapi10.mallcoo.cn/Event/Promotion/V1/GetDetail/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

接口调用参数

名称	数据类型	必填	说明
PromotionID	long	是	活动ID

参数示例

{
  "PromotionID": 273
}

返回结果

名称	数据类型	必填	说明
Code	int	是	状态码
Data	Json	是	返回数据
Message	string	是	返回状态描述

Data

名称	数据类型	必填	说明
PromotionID	long	是	优惠ID
Name	string	是	活动名称
SubTitle	string	否	副标题
Photo	string	是	头图
Article	string	是	优惠详情（富文本）
Pact	string	是	优惠规则
StartTime	DateTime	是	开始时间
EndTime	DateTime	是	结束时间
Rank	int	是	排序权重
PromotionCategoryID	long	否	优惠一级分类ID
PromotionSubCategoryID	long	否	优惠二级分类ID
CouponList	List<Promotion_Coupon>	是	券列表
PageUrl	string	是	猫酷对应的url

Promotion_Coupon

名称	数据类型	必填	说明
CouponType	int	是	卡券类型（详情看枚举字典，这里只返回Int类型）
CouponName	string	是	券标题(名称)
IsFixedDate	bool	是	是否固定日期 （券的有效期有两种，一种为固定日期，一种为领取后XX天生效或领取后XX天生效，生效XX天）
FixedDateBegin	DateTime	否	固定日期[开始] （【是否固定日期】等于true时有效）
FixedDateEnd	DateTime	否	固定日期[结束] （【是否固定日期】等于true时有效）
DelayEffectiveDays	int	否	延后生效天数 （【是否固定日期】等于false时有效）
EffectiveDays	int	否	有效天数（【是否固定日期】等于false时有效）

返回示例

{
  "Code": 1,
  "Data": 
  {
	"PromotionID": 274,
	"Name": "8.25优惠",
	"SubTitle": "",
	"Pact": "优惠不惜、抢购不止",
	"StartTime": "2016-08-25 00:00:00",
	"EndTime": "2016-08-31 00:00:00",
	"Rank": 50,
	"Photo": "http://i1.mallcoo.cn/sp_mall/82de37a0-db14-4c23-aca9-58900758c2e7.jpg",
	"Article": "优惠不惜、抢购不止",
	"PromotionCategoryID": 1,
	"PromotionSubCategoryID": null,
	"CouponList":
	[
		{
		"CouponType":1,
		"CouponName":"代金券",
		"IsFixedDate": false,
		"FixedDateBegin": "0001-01-01 00:00:00",
		"FixedDateEnd": "0001-01-01 23:59:59",
		"DelayEffectiveDays": 0,
		"EffectiveDays": 90,
		}
	],
	"PageUrl": "http://m.mallcoo.cn/a/home/10008/promotion/detail?id=1310",
   },
  "Message": "成功"
}