猫酷开放平台

# 团购

# 团购分类列表

TIP

用于从猫酷系统获取团购分类

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

# 接口调用参数

无

# 调用示例
{
}
1
2

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
CategoryID long 是 团购分类ID
Name string 是 名称
Weight int 是 权重
# 返回示例

{
    "Code": 1, 
    "Data": [
        {
            "CategoryID": 31, 
            "Name": "秒杀", 
            "Weight": 2
        }, 
        {
            "CategoryID": 12, 
            "Name": "精选团购", 
            "Weight": 1
        }, 
        {
            "CategoryID": 10, 
            "Name": "超值团购", 
            "Weight": 0
        }
    ], 
    "Message": "成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24



# 团购列表

TIP

用于从猫酷系统获取团购列表

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

# 接口调用参数

名称 数据类型 必填 说明
TuanType int 否 团购类型(1:普通;3:秒杀)
CategoryID long 否 团购分类ID
PageIndex int 是 当前页码（默认1）
PageSize int 是 每页数量（默认10）
# 调用示例

{
    "TuanType": null, 
    "CategoryID": 12, 
    "PageIndex": 1, 
    "PageSize": 2
}
1
2
3
4
5
6
7
8

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
GrouponID long 是 团购ID
Name string 是 团购名称
CategoryID long 是 分类ID
Type int 是 类型(1:普通;3:秒杀)
ShelfStatus int 是 上下架状态1.上架，0.下架
StartTime DateTime 是 团购开始时间（有效开始时间）
EndTime DateTime 是 团购结束时间 （有效结束时间）
ShowStartTime DateTime 是 展示开始时间
ShowEndTime DateTime 是 展示结束时间
BigImage string 是 头图(大图)
SmallImage string 否 列表小图
Price double 是 团购价（单位：元）
MarketPrice double 是 市场价（单位：元）
Showable bool 是 是否在列表中展示
Refundable bool 是 是否支持退款
Saled int 是 已购人数
Stock int 是 剩余库存
# 返回示例
{
    "Code": 1, 
    "Data": [
        {
            "GrouponID": 279, 
            "Name": "团购名称", 
            "CategoryID": 10, 
            "Type": 1, 
            "ShelfStatus": 1,
            "StartTime": "2017/08/22 17:25:00", 
            "EndTime": "2017/09/22 16:35:55", 
            "ShowStartTime": "2017/08/22 17:15:22", 
            "ShowEndTime": "2017/09/22 16:55:55", 
            "BigImage": "http://i1.mallcoo.cn/sp_mall/59t5e308-b7dd-4d0e-82fd-e8f72abd3dde_0.jpg", 
            "SmallImage": "", 
            "Price": 8, 
            "MarketPrice": 0, 
            "Saled": 2, 
            "Showable": true, 
            "Refundable": false,
            "Stock":88
        }, 
        {
            "GrouponID": 213, 
            "Name": "团购名称", 
            "CategoryID": 10, 
            "Type": 1, 
            "ShelfStatus": 1,
            "StartTime": "2017/03/28 00:00:00", 
            "EndTime": "2020/12/31 00:00:00", 
            "ShowStartTime": "2017/03/28 00:00:00", 
            "ShowEndTime": "2020/12/31 00:00:00", 
            "BigImage": "http://i1.mallcoo.cn/sp_mall/86a4e9fb-6752-45a6-ad97-a296132c2fe9_0.jpg", 
            "SmallImage": "", 
            "Price": 0.01, 
            "MarketPrice": 0, 
            "Saled": 0, 
            "Showable": true, 
            "Refundable": true,
            "Stock":88

        }
    ], 
    "Message": "成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47



# 团购详情

TIP

用于从猫酷系统获取团购详情

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

# 接口调用参数

名称 数据类型 必填 说明
GrouponID long 是 团购ID
# 调用示例

{
  "GrouponID": "1000"
}
1
2
3
4
5

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
GrouponID long 是 团购ID
Name string 是 团购名称
CategoryID long 是 分类ID
Type int 是 类型(1:普通;3:秒杀)
ShelfStatus int 是 上下架状态1.上架，0.下架
StartTime DateTime 是 团购开始时间（有效开始时间）
EndTime DateTime 是 团购结束时间 （有效结束时间）
ShowStartTime DateTime 是 展示开始时间
ShowEndTime DateTime 是 展示结束时间
BigImage string 是 头图(大图)
Price double 是 团购价（单位：元）
MarketPrice double 是 市场价（单位：元）
Saled int 是 已团人数（已购人数）
Refundable bool 是 是否支持退款
Showable bool 是 是否在列表中展示
NeedMallCard bool 是 是否限制购买权限
BuyLimit int 是 限购数量(0 表示不限购)
BuyMinLimit int 是 起步购数量
MallCardIDs long[] 是 购买等级
TuanDetail string 是 团购详情
TuanReadme string 是 购买须知
TuanUrl string 是 团购url
Stock int 是 剩余库存
# 返回示例
{
    "Code": 1, 
    "Data": {
        "GrouponID": 374, 
        "Name": "测试小图", 
        "CategoryID": 12, 
        "Type": 1, 
        "ShelfStatus": 0, 
        "StartTime": "2018/04/04 14:56:46", 
        "EndTime": "2018/05/04 14:56:46", 
        "ShowStartTime": "2018/04/04 14:56:46", 
        "ShowEndTime": "2018/05/04 14:56:46", 
        "BigImage": "http://i1.mallcoo.cn/sp_mall/59z4n391-56e1-4c19-8f71-f92c1642064e_0.jpg", 
        "Price": 3, 
        "MarketPrice": 10, 
        "Saled": 2, 
        "Refundable": false, 
        "Showable": true, 
        "NeedMallCard": false, 
        "BuyLimit": 1, 
        "BuyMinLimit": 1, 
        "MallCardIDs": [ ], 
        "TuanDetail": "33333333333333", 
        "TuanReadme": "33333333333333", 
        "TuanUrl": "https://m.mallcoo.cn/a/tuan/10010/tuan/detail?tid=374",
        "Stock":88
    }, 
    "Message": "成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30



# 增加用户团购机会

TIP

增加用户团购机会

接口地址：https://openapi10.mallcoo.cn/Groupon/v1/AddTuanChance (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四选一)
ActivityID long 是 营销活动ID
BusinessOrderID string 是 业务订单号，用于判重，同一笔交易只能增加一次机会
Count int 是 本次增加机会(大于0)
# 调用示例

{
  "Mobile": "13156554896",
  "ActivityID":133,
  "BusinessOrderID":"blk0222335",
  "Count":2
}
1
2
3
4
5
6
7
8

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Message string 是 返回状态描述
# 返回示例
{
    "Code": 1, 
    "Message": "成功"
}
1
2
3
4
5



# 查询团购订单

TIP

查询团购订单

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

# 接口调用参数

名称 数据类型 必填 说明
Mobile string 否 手机号(OpenUserID、Mobile、MallCardNo三选一)
MallCardNo string 否 会员卡号(OpenUserID、Mobile、MallCardNo三选一)
OpenUserID string 否 用户Id(OpenUserID、Mobile、MallCardNo三选一)
OrderStatus string 否 订单状态值加“-”拼接 全部:不传值 待支付：0-10 已支付：40-50-60-61 订单关闭：20-30
CategoryIDList List 否 团购分类ID列表，List类型
PagingID string 否 分页记录ID（现在只支持”下一页“分页形式，第一页传0，获取下一页时传入该值）
PageSize int 否 每页数量（不填默认10）
# 调用示例

{
	"PageSize": 10,
	"Mobile": "17521311281",
	"MallCardNo": "",
	"OpenUserID": 0,
	"CategoryIDList": [],
	"PagingID": "",
	"OrderStatus": "20-30"
}
1
2
3
4
5
6
7
8
9
10
11

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
TuanVersion int 是 团购版本
TuanType int 是 团购类型 1 团购 2 拼团 3 秒杀
TuanID long 是 团购ID
OrderStatus int 是 订单状态 20 已取消 10 待支付 30 已过期 40 已支付 50 等待发货 60 已完成 61 发货失败 70 积分抵扣失败 80 拼团已过期 90 开团有效期已过 100 支付中 0 初始化
MarketPrice double 是 市场价
TotalPrice double 是 总价
Count int 是 购买数量
TuanBigImage string 是 团购大图
BuyerMsg string 是 买家留言
TuanName string 是 团购名称
BuyerMsgTitle string 是 买家留言标题
OrderID string 是 订单号
PayCash double 是 支付现金(团购实付总额)
TuanPrice double 是 团购价
CashPayStatus int 是 现金支付状态 10 等待支付 20 支付成功
PayOrderCreated bool 是 支付中心订单是否已创建
TuanSmallImage string 是 团购小图
TuanBuyLimit int 是 团购限购数量
PayTimestamp long 是 支付时间戳（从1970年1月1日开始所经过的秒数）
ExpireTimestamp long 是 过期时间戳
CreateTimestamp long 是 下单时间戳（从1970年1月1日开始所经过的秒数）
UsedScore double 是 订单使用的积分
ScorePrice double 否 积分抵扣金额
# 返回示例
{
	"Code": 1,
	"Data": {
		"Orders": [{
			"TuanID": 1662,
			"TuanVersion": 2,
			"TuanType": 2,
			"MarketPrice": 0,
			"OrderStatus": 30,
			"TotalPrice": 0.01,
			"TuanName": "拼团测试20211104",
			"Count": 1,
			"TuanBuyLimit": 0,
			"BuyerMsgTitle": null,
			"CashPayStatus": 10,
			"OrderID": "TG01636946717099177003",
			"TuanSmallImage": "",
			"TuanBigImage": "https://i1-t.mallcoo.cn/sp_mall/60l62b36-5cb6-44fa-98b7-d5cb373e8642_0.png",
			"BuyerMsg": null,
			"TuanPrice": 0.03,
			"PayTimestamp": 0,
			"PayOrderCreated": true,
			"PayCash": 0.01,
			"ExpireTimestamp": 1636947617,
			"CreateTimestamp": 1636946716,
			"ScorePrice": 0,
			"UsedScore": 0
		}]
	},
	"Message": "成功",
	"Extension": []
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
Last Updated: 2021/11/22 下午7:52:39

← 礼品 →