猫酷开放平台

# 后台用户

# 基本流程图

sequenceDiagram participant User as 用户 participant Dev as 第三方平台 participant Mallcoo as MallcooAuthServer User->>Dev: 访问 Dev->>Mallcoo: 用户需要授权 Mallcoo-->>Dev: 授权成功，重定向并带上Ticket Dev->>Mallcoo: 通过Ticket换取OpenUserID和用户信息 Mallcoo-->>Dev: 返回，OpenUserID和用户信息

标准oauth2.0接口获取用户信息流程如上图所示，当用户访问第三方应用时，若第三方应用获取不到用户身份，需重定向到Mallcoo AuthServer，Mallcoo AuthServer返回Ticket，第三方应用再根据Ticket获取OpenUserID和用户基本信息，并保持用户身份。 目前Ticket的过期时间为5分钟。此外也提供UserToken查询用户信息，UserToken的有效期为30天



# 后台用户基础信息授权

TIP

后台用户基础信息授权登录地址

接口地址：https://mp.mallcoo.cn/a/open/MpUser/V1/OAuth/BaseInfo/ (opens new window)
请求类型：Redirect
参数类型：Url传参

# 接口调用参数

名称 数据类型 必填 说明
AppID string 是 应用ID（由猫酷统一提供）
PublicKey string 是 公钥（由猫酷统一提供）
CallbackUrl string 是 回调地址（一定要进行URL编码）
# 参数示例
{
  "AppID": "58b2fb883ae74e7428e0duif",
  "PublicKey": "8950b7de34f89553",
  "CallbackUrl": "http://www.mallcoo.cn/"
}
1
2
3
4
5

# 返回结果

名称 数据类型 必填 说明
Ticket string 是 Ticket（返回结果需要先进行URL解码）
# 返回示例

http://www.mallcoo.cn/?Ticket=b774cf727e0a1c9c
1
2
3



# 获取UserToken

TIP

根据Ticket获取UserToken

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

# 接口调用参数

名称 数据类型 必填 说明
Ticket string 是 Ticket
# 参数示例
{ 
  "Ticket": "b774cf727e0a1c9c" 
}
1
2
3

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserId string 是 用户在当前【开发者账号+项目（集团）】
下的唯一标识(相当于用户ID)
NickName string 是 用户昵称
RealName string 是 真实姓名
Mobile string 否 手机号码
Company string 否 所属公司
McShopID string 否 该商户在猫酷系统中的唯一编号
DevShopID string 否 该商户在本开发者中的唯一编号，若使用此编号，则需提前将商户对应编号导入猫酷系统
UserToken string 是 用户Token
IdentityType Enum 是 用户身份
# IdentityType
枚举值 描述描述
2 单商场用户
3 单商户用户
4 多商场用户
5 多商户用户
6 运营用户
8 集团用户
# 返回示例
{
    "Code": 1,
    "Data": {
        "OpenUserId": "9799d00b6cb7b7f4",
        "NickName": "yunying",
        "RealName": "",
        "Mobile": "15888888888",
        "Company": "",
        "McShopID": "1000450",
        "DevShopID": "111191",
        "UserToken": "2cd92dc8f73ed7a3",
        "IdentityType": 6
    },
    "Message": "成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15



# 根据UserToken获取用户信息

TIP

根据UserToken获取用户信息

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

# 接口调用参数

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

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
OpenUserId string 是 用户在当前【开发者账号+项目（集团）】
下的唯一标识(相当于用户ID)
NickName string 是 用户昵称
RealName string 是 真实姓名
Mobile string 否 手机号码
Company string 否 所属公司
McShopID string 否 该商户在猫酷系统中的唯一编号
DevShopID string 否 该商户在本开发者中的唯一编号，若使用此编号，则需提前将商户对应编号导入猫酷系统
UserToken string 是 用户Token
IdentityType Enum 是 用户身份
# IdentityType
枚举值 描述描述
2 单商场用户
3 单商户用户
4 多商场用户
5 多商户用户
6 运营用户
8 集团用户
# 返回示例
{
    "Code": 1,
    "Data": {
        "OpenUserId": "9799d00b6cb7b7f4",
        "NickName": "yunying",
        "RealName": "",
        "Mobile": "15888888888",
        "Company": "",
        "IdentityType": 6,
        "UserToken": "2cd92dc8f73ed7a3",
        "McShopID": "1000450",
        "DevShopID": "111191"
    },
    "Message": "成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15



# 根据OpenUserID获取用户信息

TIP

根据OpenUserID获取用户信息

接口地址：https://openapi10.mallcoo.cn/MpUser/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 是 用户在当前【开发者账号+项目（集团）】
下的唯一标识(相当于用户ID)
NickName string 是 用户昵称
RealName string 是 真实姓名
Mobile string 否 手机号码
Company string 否 所属公司
McShopID string 否 该商户在猫酷系统中的唯一编号
DevShopID string 否 该商户在本开发者中的唯一编号，若使用此编号，则需提前将商户对应编号导入猫酷系统
UserToken string 是 用户Token
IdentityType Enum 是 用户身份
# IdentityType
枚举值 描述描述
2 单商场用户
3 单商户用户
4 多商场用户
5 多商户用户
6 运营用户
8 集团用户
# 返回示例
{
    "Code": 1,
    "Data": {
        "OpenUserId": "9799d00b6cb7b7f4",
        "NickName": "yunying",
        "RealName": "",
        "Mobile": "15888888888",
        "Company": "",
        "IdentityType": 6,
        "McShopID": "1000450",
        "DevShopID": "111191"
    },
    "Message": "成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14



# 后台用户授权退出

TIP

后台用户授权退出地址

接口地址：https://mp.mallcoo.cn/a/open/MpUser/V1/OAuth/LogOut (opens new window)
请求类型：Redirect
参数类型：Url传参

# 接口调用参数

名称 数据类型 必填 说明
AppID string 是 应用ID（由猫酷统一提供）
PublicKey string 是 公钥（由猫酷统一提供）
CallbackUrl string 是 回调地址（一定要进行URL编码）
# 参数示例
{
  "AppID": "58b2fb883ae74e7428e0duif",
  "PublicKey": "8950b7de34f89553",
  "CallbackUrl": "http://www.mallcoo.cn/"
}
1
2
3
4
5

# 返回结果

退出成功后直达授权登录页面，用户继续登录

Last Updated: 2020/12/17 下午3:24:52

← CRM →