# 获取管理员信息

# 1、腾讯微卡管理员oauth

# 请求方法:

GET(application/json)

# 请求地址:

https://uni.weixiao.qq.com/open/auth/manager-connect?app_key=APPKEY&redirect_uri=http://xxx.com&state=STATE

# 参数说明:

{
    "app_key": "APP_KEY",
    "redirect_uri": "REDIRECT_URI",
    "state": "STATE"
}
参数 必填 说明
app_key 腾讯微卡分配的授权凭证
redirect_uri 回调地址
state 回调之后原样返回

# 返回说明:

oauth完成后跳转链接示例:

http://xxx.com?wxcode=WXCODE&state=STATE

参数 说明
wxcode 获取管理信息的授权码,一次性
state 状态码

# 2、获取应用access_token

# 请求方法:

POST(application/json)

# 请求地址:

https://uni.weixiao.qq.com/open/cgi-bin/access-token

# 参数说明:

{
    "app_key": APP_KEY,
    "app_secret": APP_SECRET
}
参数 必填 说明
app_key 腾讯微卡分配的授权凭证
app_secret 授权凭证密钥

# 响应说明:

{
    "errcode": 0,
    "errmsg": "success",
    "access_token": "xxxx",
    "expires_in": 7200
}
参数 说明
errcode 错误码
errmsg 错误信息
access_token 获取到的凭证
expires_in 有效期

# 3、获取当前登录管理员身份态

# 请求方法:

POST(application/json)

# 请求地址:

https://uni.weixiao.qq.com/open/cgi-bin/get-manager-info?access_token=access_token

# 参数说明:

{
    "wxcode": WXCODE
}
参数 必填 说明
access_token 第三方应用的权限凭证
wxcode 腾讯微卡下发的wxcode

# 响应说明:

{
    "errcode": 0,
    "errmsg": "success"
    "user_id": "oJBUeuGd04PY53N2KVICrzNGeMSM",
    "name": "NAME", // 管理员微信名称
    "schools": [
        {
            "school_code": "SCHOOL_CODE",
            "school_name": "SCHOOL_NAME",
            "host": "https://uni.weixiao.qq.com"
        },
        {
            
        }
    ],
    "manager_real_info": {
        "card_number": "CARDNUMBER", // 管理员电子卡号
        "name": "NAME",      // 管理员姓名
        "identity_type": "1" // 身份类型,1为其他,2为学生,3为教职工,4为校友
    }, // 管理员实名信息,仅当管理员有实名信息时有此字段
    "media_info": {
        "app_id": "APP_ID",
        "media_id": "MEDIA_ID"
    },
    "cur_school": {
        "school_code": "SCHOOL_CODE",
        "school_name": "SCHOOL_NAME",
        "host": "https://uni.weixiao.qq.com"
    },
    "role_id": 1,
    "parent_id": 0
}
参数 说明
errcode 错误码
errmsg 错误信息
user_id 管理员id
name 管理员名字
schools 管理员有权限管理的主体列表
app_id 主体主公众号APPID
media_id 主体主公众号原始ID
school_code 主体code
school_name 主体名称
host 主体所在的平台的地址
cur_school 管理员当前管理的主体
role_id 管理员所在角色组id
parent_id 管理员所在角色组的上一级角色组id

# 错误时返回:

{
    "errcode": "6001",
    "errmsg": "invalid code",
}

目前接入腾讯微卡的学校或者企业分布在多个平台中,获取管理员信息时会附带主体所在的平台地址,后续调用获取主体信息接口时可自行替换请求地址(推荐),如果没有进行地址替换,腾讯微卡会转发到相应的平台,产生的耗时可能会略高于直接请求相应的平台。