# 用户

# 获取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