# 礼品

# 礼品分类列表

TIP

获取该商场下礼品分类列表

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

# 接口调用参数

无

# 调用示例

{
}

1
2

# 返回结果

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

# Data

名称	数据类型	必填	说明
GiftCategoryID	long	是	礼品分类ID
Name	string	是	名称
Rank	string	是	排序权重

# 返回示例


{
  "Code": 1,
  "Data": 
  [
      {
        "GiftCategoryID": 1,
        "Name": "礼品分类",
        "Rank": 1,
      },
  ],
  "Message": "成功"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 礼品列表

TIP

仅获取该商场下礼品列表信息

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

# 接口调用参数

名称	数据类型	必填	说明
GiftCategoryID	long	否	礼品分类ID
PageSize	int	否	每页数量（默认10）
PageIndex	int	否	当前页码（默认1）

# 调用示例


{
  "GiftCategoryID": 1,
  "PageIndex": 1,
  "PageSize": 10,
}

1
2
3
4
5
6
7

# 返回结果

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

# Data

名称	数据类型	必填	说明
GiftID	long	是	礼品ID
Name	string	是	名称
GiftCategoryID	long	否	所属分类ID
Photo	string	是	头图
Thumbnail	string	是	小图
Rank	int	是	排序权重
CurrencyType	int	是	货币类型（1:积分）
CurrencyValue	int	是	货币值
Stock	int	是	库存
OnlineTime	DateTime	是	上架时间
OfflineTime	DateTime	是	下架时间

# 返回示例


{
  "Code": 1,
  "Data": 
  [
      {
	"GiftID": 267,
	"Name": "我的礼品",
	"GiftCategoryID": 1,
	"Photo": "http://i1.mallcoo.cn/sp_mall/82de37a0-db14-4c23-aca9-58900758c2e7.jpg",
    "Thumbnail": "http://i1.mallcoo.cn/sp_mall/82de37a0-db14-4c23-aca9-58900758c2e7.jpg",
	"Rank": 1,
	"CurrencyType": 1,
	"CurrencyValue": 1000,
	"Stock": 500,
	"OnlineTime": "2016-08-25 00:00:00",
	"OfflineTime": "2016-08-31 00:00:00",
      },
  ],
  "Message": "成功"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

# 礼品详情

TIP

获取该礼品详情信息

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

# 接口调用参数

名称	数据类型	必填	说明
GiftID	long	是	礼品ID

# 调用示例


{
  "GiftID": 100
}

1
2
3
4
5

# 返回结果

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

# Data

名称	数据类型	必填	说明
GiftID	long	是	礼品ID
Name	string	是	名称
GiftCategoryID	long	否	所属分类ID
Photo	string	是	头图
Rank	int	是	排序权重
Stock	int	是	库存
OnlineTime	DateTime	是	上架时间
OfflineTime	DateTime	是	下架时间
CurrencyType	int	是	货币类型（1\|积分）
CurrencyValue	int	是	货币值
IsNeedCard	bool	是	是否仅限会员购买
MallCardTypes	string	否	可购买的会员等级（如果IsNeedCard为true,则一定返回）
Content	string	否	礼品兑换说明（富文本）
PageUrl	string	是	猫酷对应的url

# 返回示例


{
  "Code": 1,
  "Data": 
  {
	"GiftID": 267,
	"Name": "我的礼品",
	"GiftCategoryID": 1,
	"Photo": "http://i1.mallcoo.cn/sp_mall/82de37a0-db14-4c23-aca9-58900758c2e7.jpg",
	"Rank": 1,
	"Stock": 500,
	"OnlineTime": "2016-08-25 00:00:00",
	"OfflineTime": "2016-08-31 00:00:00",
	"CurrencyType": 1,
	"CurrencyValue": 1000,
	"IsNeedCard": true,
	"MallCardTypes": "金卡,银卡",
	"Content":"礼品兑换说明",
	"PageUrl": "http://m.mallcoo.cn/a/gift/10010/detail?gid=267",
   },
  "Message": "成功"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# 增加大礼包机会

TIP

增加大礼包机会

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

# 接口调用参数

名称	数据类型	必填	说明
OpenUserID	string	是	用户在当前应用下的唯一标识(相当于用户ID)(与Mobile、MallCardNo、RefID四选一)
Mobile	string	是	手机号(与OpenUserID、MallCardNo、RefID四选一)
MallCardNo	string	是	会员卡号(与OpenUserID、Mobile、RefID四选一)
RefID	string	是	第三方会员ID(猫酷的外部编号)(与OpenUserID、Mobile、MallCardNo四选一)
PackageRuleID	long	是	套餐大礼包ID
Count	int	是	本次增加机会(大于0)

# 调用示例


{
  "Mobile": "13156554896",
  "PackageRuleID":133,
  "Count":2
}

1
2
3
4
5
6
7

# 返回结果

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

# 返回示例

{
    "Code": 1, 
    "Message": "成功"
}

1
2
3
4
5

← 团购车场 →