猫酷开放平台

# 付费会员

# 根据手机号或会员卡号查询付费会员信息

TIP

当第三方应用需要判断用户身份时，需要调用此接口来获得用户付费会员状态。

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

# 接口调用参数

名称 数据类型 必填 说明
Mobile string 否 手机号[与会员卡号二选一]
MallCardNo string 否 会员卡号[与手机号二选一]

# 调用示例

{ 
  "Mobile": "13641726191",
  "MallCardNo": ""
}
1
2
3
4
5

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
MemberPlusStatus MemberPlusStatus 是 付费会员状态（从未、生效中、已过期、已冻结）
MemberPlusLevelID long 否 当前（或过期前）卡级id
MemberPlusLevelName string 否 当前（或过期前）卡级名称
FirstBuyTime DateTime 否 初次成为付费会员时间
EnableTime DateTime 否 生效时间，也是最近一次购买，激活，变更卡级的时间
ExpireTime DateTime 否 付费会员到期时间
CurEnableTime DateTime 否 当前生效中周期的开始时间
CurExpireTime DateTime 否 当前生效中周期的结束时间
# MemberPlusStatus
枚举 枚举值 描述
Never 1 从未
Take_Effect 2 生效中
Expire 3 已过期
Freeze 4 已冻结
# 返回示例
{
	"Code": 1,
	"Data": {
		"MemberPlusStatus": 2,
        "MemberPlusLevelID":0,
		"MemberPlusLevelName":null,
		"FirstBuyTime": "2018/08/30 16:29:05",
        "EnableTime": "2018/08/30 00:00:00",
		"ExpireTime": "2018/11/29 23:59:59",
        "CurEnableTime": "2018/11/29 23:59:59",
        "CurExpireTime": "2018/11/29 23:59:59"
		
	},
	"Message": null,
	"Extension": []
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17



# 根据用户ID查询付费会员身份

TIP

当第三方应用需要判断用户身份时，需要调用此接口来获得用户付费会员状态。

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

# 接口调用参数

名称 数据类型 必填 说明
OpenUserID string 是 开放平台用户ID

# 调用示例

{ 
  "OpenUserID": "dbdf47251e15c363"
}
1
2
3
4

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
MemberPlusStatusC MemberPlusStatusC 是 付费会员状态
MemberPlusLevelID long 否 当前（或过期前）卡级id
MemberPlusLevelName string 否 当前（或过期前）卡级名称
FirstBuyTime DateTime 否 初次成为付费会员时间
EnableTime DateTime 否 生效时间，也是最近一次购买，激活，变更卡级的时间
ExpireTime DateTime 否 付费会员到期时间
CurEnableTime DateTime 否 当前生效中周期的开始时间
CurExpireTime DateTime 否 当前生效中周期的结束时间
# MemberPlusStatusC
枚举 枚举值 描述
Never 1 从未
Take_Effect 2 生效中
Expire 3 已过期
Freeze 4 已冻结

返回结果（JSON版）：

{
	"Code": 1,
	"Data": {
		"MemberPlusStatusC": 2,
        "MemberPlusLevelID":0,
		"MemberPlusLevelName":null
		"FirstBuyTime": "2018/08/30 16:29:05",
		"ExpireTime": "2018/11/29 23:59:59",
		"EnableTime": "2018/08/30 00:00:00",
        "CurEnableTime": "2018/11/29 23:59:59",
        "CurExpireTime": "2018/11/29 23:59:59"
	},
	"Message": null,
	"Extension": []
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16



# 根据手机号/会员卡号传入付费会员权益发放记录

TIP

在第三方给付费会员发放权益后，应该调用此接口把权益发放的记录给付费会员卡系统，以便显示权益发放进度条和后期统计权益使用情况。

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

# 接口调用参数

名称 数据类型 必填 说明
TransID string 是 事物ID
Mobile string 否 用户手机号【与用户会员卡号二选一】
MallCardNo string 否 用户会员卡号【与用户手机号二选一】
PrivilegeID long 是 权益ID
PrivilegeGrantChannel PrivilegeGrantChannel 是 发放渠道
PrivilegeGrantType PrivilegeGrantType 是 权益发放类型
GrantContent string 否 权益发放详情描述 必须UTF8编码
Cost double 否 本次发放权益对应优惠价值
GrantTime DateTime 是 权益发放时间
# PrivilegeGrantChannel
枚举 枚举值 描述
OffLine_Pos 1 线下POS
Marketing_Automation 2 自动化营销
MemberProCard 3 付费会员
CRM 4 CRM
# PrivilegeGrantType
枚举 枚举值 描述
Marketing_Automation_Grant 1 自动化营销发放
OffLine_Pay_Discounts 2 线下付款优惠
Coupon 3 券
Point 4 积分
RedPacket 5 红包
Consume_Double_Point 6 多倍积分
Other 30 其他

# 调用示例

{ 
    "TransID": "e51c1c060eae48d8a3f85037eabb0841",
	"Mobile": "13641726191",
	"MallCardNo": null,
	"PrivilegeID": 16,
	"GrantChannel": 3,
	"GrantType": 6,
	"GrantContent": "123",
	"Cost": 8.88,
	"GrantTime": "2018-08-31 17:09:52",
}
1
2
3
4
5
6
7
8
9
10
11
12

# 返回结果

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

# 返回示例

{
	"Code": 1,	
	"Message": "成功"
}
1
2
3
4
5



# 根据用户ID传入付费会员权益发放记录

TIP

在第三方给付费会员发放权益后，应该调用此接口把权益发放的记录给付费会员卡系统，以便显示权益发放进度条和后期统计权益使用情况。

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

# 接口调用参数

名称 数据类型 必填 说明
TransID string 是 事物ID
OpenUserID string 是 开放平台用户ID
PrivilegeID long 是 权益ID
PrivilegeGrantChannel PrivilegeGrantChannel 是 发放渠道
PrivilegeGrantType PrivilegeGrantType 是 权益发放类型
GrantContent string 否 权益发放详情描述 必须UTF8编码
Cost double 否 本次发放权益对应优惠价值
GrantTime DateTime 是 权益发放时间
# PrivilegeGrantChannel
枚举 枚举值 描述
OffLine_Pos 1 线下POS
Marketing_Automation 2 自动化营销
MemberProCard 3 付费会员
CRM 4 CRM
# PrivilegeGrantType
枚举 枚举值 描述
Marketing_Automation_Grant 1 自动化营销发放
OffLine_Pay_Discounts 2 线下付款优惠
Coupon 3 券
Point 4 积分
RedPacket 5 红包
Consume_Double_Point 6 多倍积分
Other 30 其他

# 调用示例

{ 
    "TransID": "e51c1c060eae48d8a3f85037eabb0841",
	"OpenUserID": "dbdf47251e15c363",
	"PrivilegeID": 16,
	"GrantChannel": 3,
	"GrantType": 6,
	"GrantContent": "123",
	"Cost": 8.88,
	"GrantTime": "2018-08-31 17:09:06",
}
1
2
3
4
5
6
7
8
9
10
11

# 返回结果

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

# 返回示例

{
	"Code": 1,
	"Message": "成功"
}
1
2
3
4
5
Last Updated: 2019/10/15 上午11:34:20

← 消费 →