# 用户

# 获取UserToken

TIP

使用Ticket来获取UserToken ,如何获取Ticket,请查看 接入指南

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

# 接口调用参数

名称 数据类型 必填 说明
Ticket string Ticket
# 调用示例
{ 
  "Ticket": "1234567890abcdef" 
}
1
2
3

# 返回结果

名称 数据类型 必填 说明
Code int 状态码
Data Json 返回数据
Message string 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 用户在当前【开发者账号+项目(集团)】
下的唯一标识(相当于用户ID)
NickName string 用户昵称
Avatar string 用户头像URL
Mobile string 手机号码【默认不返回,需单独申请高级访问权限】
WXOpenID string 微信OpenID
UserToken string 用户Token
Expires long 过期时间(单位:分钟)
# 返回示例
{
  "Code": 1,
  "Data": 
  {
    "OpenUserID": "1234567890abcdef",
    "NickName": "YourNickName",
    "Avatar": "http://i1.mallcoo.cn/mc/1234567890.png",
    "Mobile": "18600000000",
    "UserToken": "1234567890abcdef",
    "WXOpenID": "1234abcd",
    "Expires": 10080
  },
  "Message": "成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14



# 根据UserToken获取用户信息

TIP

使用UserToken来获取用户信息

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

# 接口调用参数

名称 数据类型 必填 说明
UserToken string 用户Token
# 调用示例
{ 
  "UserToken": "1234567890abcdef" 
}
1
2
3

# 返回结果

名称 数据类型 必填 说明
Code int 状态码
Data Json 返回数据
Message string 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 用户在当前【开发者账号+项目(集团)】下的唯一标识
注:只有调用了授权接口才会产生
NickName string 用户昵称
Avatar string 头像URL
Mobile string 手机号码【默认不传,如有特别需要需单独申请】
InternationalMobileCode string 国际电话区号【当手机号为非中国大陆手机号时,此字段有值】
WXOpenID string 微信OpenID
UserToken string 用户Token
Expires long 过期时间(单位:分钟)
UserName string 姓名
Gender int 性别(1: 男2:女0: 未知)
Age int 年龄
Birthday string 生日
# 返回示例
{
  "Code": 1,
  "Data": 
  {
    "OpenUserID": "1234567890abcdef",
    "NickName": "YourNickName",
    "Avatar": "http://i1.mallcoo.cn/mc/1234567890.png",
    "InternationalMobileCode": "",
    "Mobile": "18600000000",
    "UserToken": "1234567890abcdef",
    "WXOpenID": "1234abcd",
    "Expires": 10000,
    "UserName": "users",
    "Gender": 1,
    "Age": 20,
    "Birthday": "1900-01-01",
  },
  "Message": "成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19



# 根据用户ID获取用户信息

TIP

使用OpenUserID来获取用户信息

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

# 接口调用参数

名称 数据类型 必填 说明
OpenUserID string 用户在当前【开发者账号+项目(集团)】下的唯一标识(相当于用户ID)
# 调用示例
{ 
  "OpenUserID": "252117ba5367449c" 
}
1
2
3

# 返回结果

名称 数据类型 必填 说明
Code int 状态码
Data Json 返回数据
Message string 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 用户在当前【开发者账号+项目(集团)】下的唯一标识
注:只有调用了授权接口才会产生
NickName string 用户昵称
Avatar string 头像URL
Mobile string 手机号码【默认不传,如有特别需要需单独申请】
InternationalMobileCode string 国际电话区号【当手机号为非中国大陆手机号时,此字段有值】
WXOpenID string 微信OpenID
UserName string 姓名
Gender int 性别(1: 男2:女0: 未知)
Age int 年龄
Birthday string 生日
UserCreateTime DateTime 用户注册时间
# 返回示例
{
  "Code": 1,
  "Data": 
  {
    "OpenUserID": "252117ba5367449c",
    "NickName": "Mallcoo68d14",
    "Avatar": "http://i1.mallcoo.cn/mc/56465fb0-7d5f-4940-bb9e-a09cb3002f0b_0.png",
    "Mobile": "18626596531",
    "InternationalMobileCode": "",
    "WXOpenID": "sdjflk5s425",
    "UserName": "hei",
    "Gender": 1,
    "Age": 27,
    "Birthday": "1990-01-01",
    "UserCreateTime": "1990-01-01 12:11:22"
  },
  "Message": "成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18



# 根据UserToken获取会员信息

TIP

使用UserToken来获取会员信息

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

# 接口调用参数

名称 数据类型 必填 说明
UserToken string 用户Token
# 调用示例
{ 
  "UserToken": "12a53d83dd02e89a" 
}
1
2
3

# 返回结果

名称 数据类型 必填 说明
Code int 状态码
Data Json 返回数据
Message string 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 用户在当前【开发者账号+项目(集团)】下的唯一标识
注:只有调用了授权接口才会产生
NickName string 用户昵称
Avatar string 头像URL
Mobile string 手机号码【默认不传,如有特别需要需单独申请】
InternationalMobileCode string 国际电话区号【当手机号为非中国大陆手机号时,此字段有值】
UserToken string 用户Token
WXOpenID string 微信OpenID
MallCardNo string 猫酷会员卡号
MallCardName string 猫酷会员卡名称
ThirdPartyCardID string 第三方会员ID
ThirdPartyCardNo string 第三方会员卡号
Score double 积分
Expires long 过期时间(单位:分钟)
MallCardTypeID long 猫酷会员卡类型ID
UserName string 姓名
Gender int 性别(1: 男2:女0: 未知)
Age int 年龄
Birthday string 生日
UserCreateTime DateTime 用户注册时间
MallCardApplyTime DateTime 会员开卡时间
# 返回示例
{
   "Code": 1,
  "Data": 
  {
  "OpenUserID": "252117ba5367449c",
  "NickName": "Mallcoo68d14",
  "Avatar": "http://i1.mallcoo.cn/mc/56465fb0-7d5f-4940-bb9e-a09cb3002f0b_0.png",
  "Mobile": "18626596531",
  "InternationalMobileCode": "",
  "UserToken": "400ca739e837396d",
  "WXOpenID": "oxZP_jlhCAzG_6p6g85QUQJHdaY",
  "MallCardNo": "88888888",
  "MallCardName": "金卡",
  "ThirdPartyCardID": "88888888",
  "ThirdPartyCardNo": "88888888",
  "Score": 0,
  "Expires": 10080,
  "MallCardTypeID": 1,
  "UserName": "hei",
  "Gender": 1,
  "Age": 27,
  "Birthday": "1990-01-01",
  "UserCreateTime": "1990-01-01 12:11:22",
  "MallCardApplyTime": "1990-01-01 12:11:22"
  },
  "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



# 根据手机号获取会员信息

TIP

根据手机号获取会员信息

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

# 接口调用参数

名称 数据类型 必填 说明
Mobile string 手机号
# 调用示例
{ 
  "Mobile": "15901996272"
}
1
2
3

# 返回结果

名称 数据类型 必填 说明
Code int 状态码
Data Json 返回数据
Message string 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 用户在当前【开发者账号+项目(集团)】下的唯一标识
注:只有调用了授权接口才会产生
NickName string 用户昵称
Avatar string 头像URL
Mobile string 手机号码【默认不传,如有特别需要需单独申请】
InternationalMobileCode string 国际电话区号【当手机号为非中国大陆手机号时,此字段有值】
WXOpenID string 微信OpenID
MallCardNo string 猫酷会员卡号
MallCardName string 猫酷会员卡名称
ThirdPartyCardID string 第三方会员ID
ThirdPartyCardNo string 第三方会员卡号
Score double 积分
MallCardTypeID long 猫酷会员卡类型ID
UserName string 姓名
Gender int 性别(1: 男2:女0: 未知)
Age int 年龄
Birthday string 生日
UserCreateTime DateTime 用户注册时间
MallCardApplyTime DateTime 会员开卡时间
# 返回示例
{
   "Code": 1,
  "Data": 
  {
  "OpenUserID": "252117ba5367449c",
  "NickName": "Mallcoo68d14",
  "Avatar": "http://i1.mallcoo.cn/mc/56465fb0-7d5f-4940-bb9e-a09cb3002f0b_0.png",
  "Mobile": "18626596531",
  "InternationalMobileCode": "",
  "WXOpenID": "oxZP_jlhCAzG_6p6g85QUQJHdaY",
  "MallCardNo": "88888888",
  "MallCardName": "金卡",
  "ThirdPartyCardID": "88888888",
  "ThirdPartyCardNo": "88888888",
  "Score": 0,
  "MallCardTypeID": 1,
  "UserName": "hei",
  "Gender": 1,
  "Age": 27,
  "Birthday": "1990-01-01",
  "UserCreateTime": "1990-01-01 12:11:22",
  "MallCardApplyTime": "1990-01-01 12:11:22"
  },
  "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



# 根据会员卡号获取会员信息

TIP

根据卡号获取会员信息

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

# 接口调用参数

名称 数据类型 必填 说明
MallCardNo string 猫酷会员卡号
# 调用示例
{ 
  "MallCardNo": "88888888"
}
1
2
3

# 返回结果

名称 数据类型 必填 说明
Code int 状态码
Data Json 返回数据
Message string 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 用户在当前【开发者账号+项目(集团)】下的唯一标识
注:只有调用了授权接口才会产生
NickName string 用户昵称
Avatar string 头像URL
Mobile string 手机号码【默认不传,如有特别需要需单独申请】
InternationalMobileCode string 国际电话区号【当手机号为非中国大陆手机号时,此字段有值】
WXOpenID string 微信OpenID
MallCardNo string 猫酷会员卡号
MallCardName string 猫酷会员卡名称
ThirdPartyCardID string 第三方会员ID
ThirdPartyCardNo string 第三方会员卡号
Score double 积分
MallCardTypeID long 猫酷会员卡类型ID
UserName string 姓名
Gender int 性别(1: 男2:女0: 未知)
Age int 年龄
Birthday string 生日
UserCreateTime DateTime 用户注册时间
MallCardApplyTime DateTime 会员开卡时间
# 返回示例
{
   "Code": 1,
  "Data": 
  {
  "OpenUserID": "252117ba5367449c",
  "NickName": "Mallcoo68d14",
  "Avatar": "http://i1.mallcoo.cn/mc/56465fb0-7d5f-4940-bb9e-a09cb3002f0b_0.png",
  "Mobile": "18626596531",
  "InternationalMobileCode": "",
  "WXOpenID": "oxZP_jlhCAzG_6p6g85QUQJHdaY",
  "MallCardNo": "88888888",
  "MallCardName": "金卡",
  "ThirdPartyCardID": "88888888",
  "ThirdPartyCardNo": "88888888",
  "Score": 0,
  "MallCardTypeID": 1,
  "UserName": "hei",
  "Gender": 1,
  "Age": 27,
  "Birthday": "1990-01-01",
  "UserCreateTime": "1990-01-01 12:11:22",
  "MallCardApplyTime": "1990-01-01 12:11:22"
  },
  "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



# 根据用户ID获取会员信息

TIP

必须使用OpenUserID来获取会员信息

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

# 接口调用参数

名称 数据类型 必填 说明
OpenUserID string 用户在当前【开发者账号+项目(集团)】下的唯一标识(相当于用户ID)
# 调用示例
{ 
  "OpenUserID": "252117ba5367449c" 
}
1
2
3

# 返回结果

名称 数据类型 必填 说明
Code int 状态码
Data Json 返回数据
Message string 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 用户在当前【开发者账号+项目(集团)】下的唯一标识
注:只有调用了授权接口才会产生
NickName string 用户昵称
Avatar string 头像URL
Mobile string 手机号码【默认不传,如有特别需要需单独申请】
InternationalMobileCode string 国际电话区号【当手机号为非中国大陆手机号时,此字段有值】
WXOpenID string 微信OpenID
MallCardNo string 猫酷会员卡号
MallCardName string 猫酷会员卡名称
ThirdPartyCardID string 第三方会员ID
ThirdPartyCardNo string 第三方会员卡号
Score double 积分
MallCardTypeID long 猫酷会员卡类型ID
UserName string 姓名
Gender int 性别(1: 男2:女0: 未知)
Age int 年龄
Birthday string 生日
UserCreateTime DateTime 用户注册时间
MallCardApplyTime DateTime 会员开卡时间
# 返回示例
{
   "Code": 1,
  "Data": 
  {
  "OpenUserID": "252117ba5367449c",
  "NickName": "Mallcoo68d14",
  "Avatar": "http://i1.mallcoo.cn/mc/56465fb0-7d5f-4940-bb9e-a09cb3002f0b_0.png",
  "Mobile": "18626596531",
  "InternationalMobileCode": "",
  "WXOpenID": "oxZP_jlhCAzG_6p6g85QUQJHdaY",
  "MallCardNo": "88888888",
  "MallCardName": "金卡",
  "ThirdPartyCardID": "88888888",
  "ThirdPartyCardNo": "88888888",
  "Score": 0,
  "MallCardTypeID": 1,
  "UserName": "hei",
  "Gender": 1,
  "Age": 27,
  "Birthday": "1990-01-01",
  "UserCreateTime": "1990-01-01 12:11:22",
  "MallCardApplyTime": "1990-01-01 12:11:22"
  },
  "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



# 根据手机号获取用户资料

TIP

根据手机号获取用户资料

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

# 接口调用参数

名称 数据类型 必填 说明
Mobile string 手机号
# 调用示例
{ 
  "Mobile": "15901996272"
}
1
2
3

# 返回结果

名称 数据类型 必填 说明
Code int 状态码
Data Json 返回数据
Message string 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 用户在当前【开发者账号+项目(集团)】下的唯一标识(相当于用户ID)(注:只有调用了授权接口才会产生)
NickName string 用户昵称
Avatar string 头像地址
Mobile string 手机号码
InternationalMobileCode string 国际电话区号【当手机号为非中国大陆手机号时,此字段有值】
WXOpenID string 微信OpenID
MallCardNo string 猫酷会员卡号
MallCardName string 猫酷会员卡名称
ThirdPartyCardID string 第三方会员ID
ThirdPartyCardNo string 第三方会员卡号
Score double 积分
MallCardTypeID long 猫酷会员卡类型ID
UserName string 姓名
Gender int 性别(0:未知,1:男,2:女)
Age int 年龄
Birthday string 生日
UserCreateTime DateTime 用户注册时间
MallCardApplyTime DateTime 会员开卡时间
IDNum string 身份证件号码
Email string 邮箱
Education int 学历(0:初中,1:高中,2:本科,3:专科,4:研究生,5:博士,6:保密)
Marital int 婚姻状况(0:未婚,1:已婚,2:保密)
HasChildren int 是否有子女(0:否,1:是,2:保密)
ChildrenCount int 子女个数
ProvincialAreas object 省市区
Address string 详细地址
Business string 职业
Income int 收入(0:3000以下,1:3000-5000,2:5000-8000,3:8000-15000,4:15000-25000,5:25000以上,6:保密)
Conveyance int 交通工具(0:地铁,1:公交,2:自驾,3:骑行,4:步行)
Wechat string 微信号
Reference string 推荐人
HobbyList List<int> 业余爱好(0:运动健身,1:DIY,2:看电影,3:吃美食,4:美容护肤,5:逛街购物,6:摄影,7:旅行)
ThirdCardNo string 第三方卡号
IsPostal bool 是否接受邮递
FocusInfoList List<int> 关注信息(0:衣服,1:箱包鞋履,2:化妆护肤,3:珠宝首饰,4:数码产品,5:家居个护,6:美食,7:配饰,8:母婴,9:亲子)
AcceptInfoTypeList List<int> 接收信息方式(0:邮件,1:邮递,2:短信,3:微信)
ShoppingInterestList List<int> 购物喜好(0:衣服,1:箱包鞋履,2:化妆护肤,3:珠宝首饰,4:数码产品,5:家居个护,6:美食,7:配饰,8:母婴,9:亲子)
ActiveInterestList List<int> 活动喜好(0:美容养生,1:K歌,2:聚餐,3:看电影)
CarNO string 车牌号
InviteCode string 邀请码
Remark1 object 备注1
Remark2 object 备注2
Remark3 object 备注3
Remark4 object 备注4
Remark5 object 备注5
Remark6 object 备注6
Remark7 object 备注7
Remark8 object 备注8
Remark9 object 备注9
Remark10 object 备注10
Remark11 object 备注11
Remark12 object 备注12
Remark13 object 备注13
Remark14 object 备注14
Remark15 object 备注15
Remark16 object 备注16
Remark17 object 备注17
Remark18 object 备注18
Remark19 object 备注19
Remark20 object 备注20
# 返回示例

{
	"Code": 1,
	"Data": {
		"OpenUserID": "1948011782fcaa86",
		"NickName": "测试",
		"Avatar": "http://wx.qlogo.cn/mmopen/wQNDuMfEcZaXQ4vjo4Fqk1sm8ctLkic4nicibBtAAM2wgzwbvKF5wicHn3S1SBWfm9lfmlmqf7rz75lf5FWva6PN7soyE971ib7N7/0",
		"Mobile": "15901614083",
    "InternationalMobileCode": "",
		"WXOpenID": "oIQJF1ddC3X9gZy9x1xkq-yspszk",
		"MallCardNo": "20170010000490",
		"MallCardName": "金卡",
		"ThirdPartyCardID": "",
		"ThirdPartyCardNo": "20170010000490",
		"Score": 81000.0,
		"MallCardTypeID": 104,
		"UserName": "",
		"Gender": 1,
		"Age": null,
		"Birthday": "",
		"UserCreateTime": "2013/10/24 10:47:45",
		"MallCardApplyTime": "2017/06/05 16:30:42",
		"IDNum": "",
		"Email": null,
		"Education": null,
		"Marital": null,
		"HasChildren": null,
		"ChildrenCount": null,
		"ProvincialAreas": null,
		"Address": "",
		"Business": "",
		"Income": null,
		"Conveyance": null,
		"Wechat": null,
		"Reference": null,
		"HobbyList": null,
		"ThirdCardNo": null,
		"IsPostal": false,
		"FocusInfoList": null,
		"AcceptInfoTypeList": null,
		"ShoppingInterestList": null,
		"ActiveInterestList": null,
		"CarNO": null,
		"InviteCode": null,
		"Remark1": null,
		"Remark2": null,
		"Remark3": null,
		"Remark4": null,
		"Remark5": null,
		"Remark6": null,
		"Remark7": null,
		"Remark8": null,
		"Remark9": null,
		"Remark10": null,
		"Remark11": null,
		"Remark12": null,
		"Remark13": null,
		"Remark14": null,
		"Remark15": null,
		"Remark16": null,
		"Remark17": null,
		"Remark18": null,
		"Remark19": null,
		"Remark20": null
	},
	"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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68



# 会员信息变更

TIP

当线下CRM中会员信息发生变更时,可调用此接口将变更信息告知猫酷平台,只对当前线上用户所绑定的会员卡进行操作

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

# 接口调用参数

名称 数据类型 必填 说明
ThirdPartyCardID string 第三方会员ID(crm会员ID),若需更新会员卡ID,此处输入的为更新前的会员卡ID
UpdateDic Dictionary VipGrade(当前会员等级,必填,如果使用中文命名,必须UTF8编码);
Bonus(当前积分,必填);
ThirdPartyCardID(第三方会员ID,非必填);
ThirdPartyCardNo(第三方会员卡号,非必填,若更新会员卡ID时会员卡号发生变化,则必须传入)
# 调用示例
{
    "ThirdPartyCardID": "201610000343",
    "UpdateDic": {
        "VipGrade": "123",//第三方会员卡等级编号
        "Bonus": "1000"
    }
}
1
2
3
4
5
6
7

# 返回结果

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



# 根据会员ID更新状态

TIP

根据会员ID更新会员的当前状态

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

# 接口调用参数

名称 数据类型 必填 说明
ThirdPartyCardID string 第三方会员ID(crm会员ID)
MallCardStatus int 会员状态,默认-1( -1删除 )
# 调用示例
{ 
	"ThirdPartyCardID": "201710000001",
	"MallCardStatus": -1,
}
1
2
3
4

# 返回结果

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



# 根据手机号给会员打标签

TIP

第三方应用可以根据此接口给Mallcoo系统内的会员打标签。标签id由猫酷系统生成,目前开发者可以让商场提供,后期会增加标签列表查询接口

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

# 接口调用参数

名称 数据类型 必填 说明
Mobile string 手机号码
TagIDList List(long) 标签ID集合
Desc string 备注(中文必须UTF8编码
# 调用示例
{ 
    "Mobile": "201710000001",
    "TagIDList":[30,31,32],
    "Desc":null
}
1
2
3
4
5

# 返回结果

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



# 根据手机号删除会员标签

TIP

第三方应用可以根据此接口删除Mallcoo系统内会员的某个标签。标签id由猫酷系统生成,目前开发者可以让商场提供,后期会增加标签列表查询接口

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

# 接口调用参数

名称 数据类型 必填 说明
Mobile string 手机号码
TagIDList List(long) 标签ID集合
Desc string 备注(中文必须UTF8编码
# 调用示例
{ 
    "Mobile": "15155145475",
    "TagIDList":[30,31,32],
    "Desc":null
}
1
2
3
4
5

# 返回结果

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



# 查询会员是否为本应用转化

TIP

本接口用来判断用户是否本开发者应用引导在mallcoo线上开绑卡的。注:只能判断在2019年1月之后在mallcoo线上开卡的

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

# 接口调用参数

名称 数据类型 必填 说明
Mobile string 手机号(与会员卡号二选一)
MallCardNo string 会员卡号(与手机号二选一)
# 调用示例
{
 "Mobile": "15155145476",
 "MallCardNo": "20190010047460",
}
1
2
3
4

# 返回结果

名称 数据类型 必填 说明
Code int 状态码
Data Json 返回数据
Message string 返回状态描述
# Data
名称 数据类型 必填 说明
MembIsDevTrans bool 该会员是否开发者引导开/绑卡的(线上)
# 返回示例
{
  "Code": 1,
  "Data": 
  {
  "MembIsDevTrans": true
  },
  "Message": "成功"
}
1
2
3
4
5
6
7
8



# 手机号直接开通会员卡

TIP

根据手机号直接开通会员卡,适用于portal等先前对于手机号已经进行过验证的场景;使用此接口开卡,需要保证商场开卡时无需填写开卡字段,或者开卡字段都是非必填的;否则会导致开卡失败。开卡失败时,会只生成用户。

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

# 接口调用参数

名称 数据类型 必填 说明
Mobile string 手机号
DataSource enum 开卡平台来源(详见枚举字典)
# 调用示例

{ 
	"Mobile": "15910456758"
}

1
2
3
4
5

# 返回结果

名称 数据类型 必填 说明
Code int 状态码
Data Json 返回数据
Message string 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 用户在当前应用下的唯一标识
# 返回示例

{
	"Code": 1,
	"Data":{"OpenUserID":"aab533a5895c8077"},
	"Message": "成功"
}

1
2
3
4
5
6
7



# 手机号直接开通会员卡(支持开卡字段及会员卡类型)

TIP

本接口用于会员在商场的C端应用进行注册开卡。由于是异步开卡,因此开发者在调用此接口,且返回结果为“成功”时,代表已成功接收请求。

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

# 接口调用参数

名称 数据类型 必填 说明
Mobile string 手机号
MallCardTypeID long 会员卡类型(不传开卡类型为默认等级)
UserInfo string 开卡字段信息(非标准Json字符串,需UTF-8 (UrlEncode)编码,注意:bool类型全部使用 0,1;多选字段用逗号拼接 “0,1,2”,如:HobbyList,FocusInfoList,AcceptInfoTypeList,ActiveInterestList 点击查看详细说明
DataSource enum 开卡平台来源(详见枚举字典)
# 调用示例

{ 
	"Mobile": "15910456758",
	"MallCardTypeID":2,
	"UserInfo": "{\"UserName\":\"stefan\",\"Gender\":\"2\",\"Age\":\"20\",\"Birthday\":\"1985-01-01\",\"IDNum\":\"411123486404196754\",\"Email\":\"stefan@mallcoo.cn\",\"Education\":\"2\",\"Marital\":\"1\",\"HasChildren\":\"2\",\"ChildrenCount\":\"0\",\"Address\":\"111\",\"Business\":\"111\",\"Income\":\"0\",\"Conveyance\":\"0\",\"Wechat\":\"111111\",\"Reference\":\"11111\",\"InviteCode\":\"11111\",\"HobbyList\":\"0,4\",\"ThirdCardNo\":\"11111\",\"IsPostal\":\"0\",\"FocusInfoList\":\"0,4,8\",\"AcceptInfoTypeList\":\"0,2\",\"ShoppingInterestList\":\"0,4,8\",\"ActiveInterestList\":\"0,2\",\"CarNO\":\"苏A11111\",\"Remark1\":\"111\",\"Remark2\":\"1111\",\"Remark3\":\"dfgfg,ghjhjjj\"}"
}

1
2
3
4
5
6
7

# 返回结果

名称 数据类型 必填 说明
Code int 状态码
Data Json 返回数据
Message string 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 用户在当前应用下的唯一标识
# 返回示例

{
	"Code": 1,
	"Data":{"OpenUserID":"aab533a5895c8077"},
	"Message": "成功"
}

1
2
3
4
5
6
7



# 根据微信OpenID获取用户信息

TIP

根据微信OpenID获取会员信息

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

# 接口调用参数

名称 数据类型 必填 说明
WXOpenID string 用户在商场服务号下的微信openid

# 调用示例


{ "WXOpenID": "oGTPpwsykmlxOBvfFgsFccGJUcNE" }

1
2
3

# 返回结果

名称 数据类型 必填 说明
Code int 状态码
Data Json 返回数据
Message string 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 用户在当前【开发者账号+项目(集团)】下的唯一标识(相当于用户ID)(注:只有调用了授权接口才会产生)
NickName string 用户昵称
Avatar string 头像地址
Mobile string 手机号码【默认不传,如有特别需要需单独申请】
InternationalMobileCode string 国际电话区号【当手机号为非中国大陆手机号时,此字段有值】
WXOpenID string 用户在商场服务号下的微信openid
UserName string 姓名
Gender int 性别(0:未知,1:男,2:女)
Age int 年龄
Birthday string 生日
UserCreateTime DateTime 用户注册时间
# 返回示例

{
   "Code": 1,
  "Data": 
  {
  "OpenUserID": "f43e9069383bb4dc",
  "NickName": "JayZ",
  "Avatar": "http://i1.mallcoo.cn/mc/56465fb0-7d5f-4940-bb9e-a09cb3002f0b_0.png",
  "Mobile": "18621300601",
  "InternationalMobileCode": "",
  "WXOpenID": "oGTPpwsykmlxOBvfFgsFccGJUcNE",
  "UserName": "破军",
  "Gender": 1,
  "Age": 27,
  "Birthday": "1990-01-01",
  "UserCreateTime": "2017-02-27 11:42:10",
  },
  "Message": "成功"
}

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



# 根据微信OpenID获取会员信息

TIP

根据微信OpenID获取会员信息

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

# 接口调用参数

名称 数据类型 必填 说明
WXOpenID string 用户在商场服务号下的微信openid

# 调用示例


{ "WXOpenID": "oGTPpwsykmlxOBvfFgsFccGJUcNE" }

1
2
3

# 返回结果

名称 数据类型 必填 说明
Code int 状态码
Data Json 返回数据
Message string 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 用户在当前【开发者账号+项目(集团)】下的唯一标识(相当于用户ID)(注:只有调用了授权接口才会产生)
NickName string 用户昵称
Avatar string 头像地址
Mobile string 手机号码
InternationalMobileCode string 国际电话区号【当手机号为非中国大陆手机号时,此字段有值】
WXOpenID string 微信OpenID
MallCardNo string 猫酷会员卡号
MallCardName string 猫酷会员卡名称
ThirdPartyCardID string 第三方会员ID
ThirdPartyCardNo string 第三方会员卡号
Score double 积分
MallCardTypeID long 猫酷会员卡类型ID
UserName string 姓名
Gender int 性别(0:未知,1:男,2:女)
Age int 年龄
Birthday string 生日
UserCreateTime DateTime 用户注册时间
MallCardApplyTime DateTime 会员开卡时间
# 返回示例

{
   "Code": 1,
  "Data": 
  {
  "OpenUserID": "252117ba5367449c",
  "NickName": "Mallcoo68d14",
  "Avatar": "http://i1.mallcoo.cn/mc/56465fb0-7d5f-4940-bb9e-a09cb3002f0b_0.png",
  "Mobile": "18626596531",
  "InternationalMobileCode": "",
  "WXOpenID": "oxZP_jlhCAzG_6p6g85QUQJHdaY",
  "MallCardNo": "88888888",
  "MallCardName": "金卡",
  "ThirdPartyCardID": "88888888",
  "ThirdPartyCardNo": "88888888",
  "Score": 0,
  "MallCardTypeID": 1,
  "UserName": "hei",
  "Gender": 1,
  "Age": 27,
  "Birthday": "1990-01-01",
  "UserCreateTime": "1990-01-01 12:11:22",
  "MallCardApplyTime": "1990-01-01 12:11:22"
  },
  "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



# 根据手机号更新会员信息

TIP

根据手机号更新会员信息,可更新的信息有:姓名、性别、年龄、出生日期、详细地址

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

# 接口调用参数

名称 数据类型 必填 说明
Mobile string 手机号
UserInfo string 要更新的会员信息(现仅支持:UserName、Gender、Age、Birthday、Address),Json字符串,需UTF-8 (UrlEncode)编码
# 调用示例
{
    "Mobile": "15908765439",
    "UserInfo": "{\"UserName\":\"Stefan1\",\"Gender\":1,\"Age\":20,\"Birthday\":\"2019-10-12T14:30:06.0444293+08:00\",\"Address\":\"地址\"}"
}
1
2
3
4

# 返回结果

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



# 根据支付宝ID获取用户信息

TIP

根据支付宝id获取用户信息

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

# 接口调用参数

名称 数据类型 必填 说明
AliUserID string 用户在支付宝下的UserID

# 调用示例


{ "AliUserID": "oGTPpwulAAbh9Q-_eAyYvbquUSrE" }

1
2
3

# 返回结果

名称 数据类型 必填 说明
Code int 状态码
Data Json 返回数据
Message string 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 用户在当前【开发者账号+项目(集团)】下的唯一标识(相当于用户ID)(注:只有调用了授权接口才会产生)
NickName string 用户昵称
Avatar string 头像地址
Mobile string 手机号码【默认不传,如有特别需要需单独申请】
InternationalMobileCode string 国际电话区号【当手机号为非中国大陆手机号时,此字段有值】
WXOpenID string 用户在商场服务号下的微信openid
UserName string 姓名
Gender int 性别(0:未知,1:男,2:女)
Age int 年龄
Birthday string 生日
# 返回示例

{
   "Code": 1,
  "Data": 
  {
  "OpenUserID": "f43e9069383bb4dc",
  "NickName": "JayZ",
  "Avatar": "http://i1.mallcoo.cn/mc/56465fb0-7d5f-4940-bb9e-a09cb3002f0b_0.png",
  "Mobile": "18621300601",
  "InternationalMobileCode": "",
  "WXOpenID": "oGTPpwsykmlxOBvfFgsFccGJUcNE",
  "UserName": "破军",
  "Gender": 1,
  "Age": 27,
  "Birthday": "1990-01-01",
  },
  "Message": "成功"
}

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

# 根据支付宝ID获取会员信息

TIP

根据支付宝ID获取会员信息

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

# 接口调用参数

名称 数据类型 必填 说明
AliUserID string 用户在支付宝下的UserID

# 调用示例


{ "AliUserID": "oGTPpwulAAbh9Q-_eAyYvbquUSrE" }

1
2
3

# 返回结果

名称 数据类型 必填 说明
Code int 状态码
Data Json 返回数据
Message string 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserID string 用户在当前【开发者账号+项目(集团)】下的唯一标识(相当于用户ID)(注:只有调用了授权接口才会产生)
NickName string 用户昵称
Avatar string 头像地址
Mobile string 手机号码
InternationalMobileCode string 国际电话区号【当手机号为非中国大陆手机号时,此字段有值】
WXOpenID string 微信OpenID
MallCardNo string 猫酷会员卡号
MallCardName string 猫酷会员卡名称
ThirdPartyCardID string 第三方会员ID
ThirdPartyCardNo string 第三方会员卡号
Score double 积分
MallCardTypeID long 猫酷会员卡类型ID
UserName string 姓名
Gender int 性别(0:未知,1:男,2:女)
Age int 年龄
Birthday string 生日
UserCreateTime DateTime 用户注册时间
MallCardApplyTime DateTime 会员开卡时间
# 返回示例

{
   "Code": 1,
  "Data": 
  {
  "OpenUserID": "252117ba5367449c",
  "NickName": "Mallcoo68d14",
  "Avatar": "http://i1.mallcoo.cn/mc/56465fb0-7d5f-4940-bb9e-a09cb3002f0b_0.png",
  "Mobile": "18626596531",
  "InternationalMobileCode": "",
  "WXOpenID": "oxZP_jlhCAzG_6p6g85QUQJHdaY",
  "MallCardNo": "88888888",
  "MallCardName": "金卡",
  "ThirdPartyCardID": "88888888",
  "ThirdPartyCardNo": "88888888",
  "Score": 0,
  "MallCardTypeID": 1,
  "UserName": "hei",
  "Gender": 1,
  "Age": 27,
  "Birthday": "1990-01-01",
  "UserCreateTime": "1990-01-01 12:11:22",
  "MallCardApplyTime": "1990-01-01 12:11:22"
  },
  "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



# 根据会员旧手机号更新会员新手机号

TIP

根据会员旧手机号更新会员新手机号

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

# 接口调用参数

名称 数据类型 必填 说明
Mobile string 新手机号
OldMobile string 旧手机号
ThirdCRMRefID string 第三方CRM关联ID
Remark string 备注(注:中文请注意编码,编码格式为:UTF-8 (UrlEncode))
UpdatorID long 修改人ID
Updator string 修改人(注:中文请注意编码,编码格式为:UTF-8 (UrlEncode))
# 调用示例

{ 
	"Mobile": "15960456758",
  "OldMobile":"15125155475",
  "ThirdCRMRefID":"23333"
}

1
2
3
4
5
6
7

# 返回结果

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

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

1
2
3
4
5
6
Last Updated: 2021/5/25 下午2:11:31