# 用户
# 获取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"
}
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": "成功"
}
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"
}
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": "成功"
}
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"
}
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": "成功"
}
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"
}
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": "成功"
}
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"
}
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": "成功"
}
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"
}
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": "成功"
}
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"
}
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": "成功"
}
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"
}
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 | 否 | 身份证件号码 |
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:步行) |
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": []
}
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"
}
}
2
3
4
5
6
7
# 返回结果
名称 | 数据类型 | 必填 | 说明 |
---|---|---|---|
Code | int | 是 | 状态码 |
Message | string | 是 | 返回状态描述 |
# 返回示例
{
"Code": 1,
"Message": "成功"
}
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,
}
2
3
4
# 返回结果
名称 | 数据类型 | 必填 | 说明 |
---|---|---|---|
Code | int | 是 | 状态码 |
Message | string | 是 | 返回状态描述 |
# 返回示例
{
"Code": 1,
"Message": "成功"
}
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
}
2
3
4
5
# 返回结果
名称 | 数据类型 | 必填 | 说明 |
---|---|---|---|
Code | int | 是 | 状态码 |
Message | string | 是 | 返回状态描述 |
# 返回示例
{
"Code": 1,
"Message": "成功"
}
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
}
2
3
4
5
# 返回结果
名称 | 数据类型 | 必填 | 说明 |
---|---|---|---|
Code | int | 是 | 状态码 |
Message | string | 是 | 返回状态描述 |
# 返回示例
{
"Code": 1,
"Message": "成功"
}
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",
}
2
3
4
# 返回结果
名称 | 数据类型 | 必填 | 说明 |
---|---|---|---|
Code | int | 是 | 状态码 |
Data | Json | 是 | 返回数据 |
Message | string | 是 | 返回状态描述 |
# Data
名称 | 数据类型 | 必填 | 说明 |
---|---|---|---|
MembIsDevTrans | bool | 是 | 该会员是否开发者引导开/绑卡的(线上) |
# 返回示例
{
"Code": 1,
"Data":
{
"MembIsDevTrans": true
},
"Message": "成功"
}
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"
}
2
3
4
5
# 返回结果
名称 | 数据类型 | 必填 | 说明 |
---|---|---|---|
Code | int | 是 | 状态码 |
Data | Json | 是 | 返回数据 |
Message | string | 是 | 返回状态描述 |
# Data
名称 | 数据类型 | 必填 | 说明 |
---|---|---|---|
OpenUserID | string | 是 | 用户在当前应用下的唯一标识 |
# 返回示例
{
"Code": 1,
"Data":{"OpenUserID":"aab533a5895c8077"},
"Message": "成功"
}
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\"}"
}
2
3
4
5
6
7
# 返回结果
名称 | 数据类型 | 必填 | 说明 |
---|---|---|---|
Code | int | 是 | 状态码 |
Data | Json | 是 | 返回数据 |
Message | string | 是 | 返回状态描述 |
# Data
名称 | 数据类型 | 必填 | 说明 |
---|---|---|---|
OpenUserID | string | 是 | 用户在当前应用下的唯一标识 |
# 返回示例
{
"Code": 1,
"Data":{"OpenUserID":"aab533a5895c8077"},
"Message": "成功"
}
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" }
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": "成功"
}
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" }
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": "成功"
}
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\":\"地址\"}"
}
2
3
4
# 返回结果
名称 | 数据类型 | 必填 | 说明 |
---|---|---|---|
Code | int | 是 | 状态码 |
Message | string | 是 | 返回状态描述 |
# 返回示例
{
"Code": 1,
"Message": "成功"
}
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" }
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": "成功"
}
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" }
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": "成功"
}
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"
}
2
3
4
5
6
7
# 返回结果
名称 | 数据类型 | 必填 | 说明 |
---|---|---|---|
Code | int | 是 | 状态码 |
Message | string | 是 | 返回状态描述 |
# 返回示例
{
"Code": 1,
"Message": "成功"
}
2
3
4
5
6