# 获取管理员信息

# 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",
}

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