腾讯微卡Wiki

该文档已下架，不再进行维护，新文档请参考点击此处

# 应用调用学生身份认证

具体的认证流程如下：

# 第一步：用户访问应用，应用通过构造OAuth2链接（参数包括相关的身份参数，以及重定向URI），将用户引导到腾讯微卡授权页

跳转到腾讯微卡指定页面，获取wxcode

授权页面地址：https://weixiao.qq.com/apps/school-auth/login?school_code=SCHOOL_CODE&app_key=APIKEY&redirect_uri=xxx

school_code: 学校代码(查看本校代码 (opens new window))

app_key: 腾讯微卡提供给应用方作为授权认证的标识 (点击申请) .html> redirect_uri: 授权后重定向的回调链接地址,地址要进行urlencode（需在腾讯微卡填写安全域名）

# 第二步：用户选择是否同意授权，若用户同意授权，则腾讯微卡会将用户定向到第一步指定的重定向的回调地址redirect_uri，同时附上一个wxcode

wxcode说明：wxcode作为换取用户id和基本信息的票据，每次认证带上的wxcode都不一样，并且每个wxcode只能使用一次，有效时间为5分钟。

# 第三步：应用通过腾讯微卡API接口使用wxcode换取网页授权access_token

# 请求方法：

POST(application/json)

# 请求地址：

https://weixiao.qq.com/apps/school-auth/access-token

# 参数说明：

{
    "app_key": APP_KEY,      
    "wxcode": CODE,            
    "app_secret": APP_SECRET
}

参数	必填	类型	示例值	说明
app_key	是	String	CA1D905AC89ACDCA	腾讯微卡授权唯一标识
wxcode	是	String	SCSDA1514276659	第一步获取到的code
app_secret	是	String	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	与app_key配套使用的app_secret

# 响应说明：

{
    "errcode": 0,
    "access_token": "xxxx"
}

参数	是否可空	说明
errcode	非空	返回码（0表示成功）
access_token	可空	access_token
errmsg	可空	出错提示信息

# 错误时返回：

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

# 第四步：通过access_token换取用户基本信息

# 请求方法：

POST(application/json)

# 请求地址：

https://weixiao.qq.com/apps/school-auth/user-info

# 参数说明：

{
    "token": "xxx"
}

参数	必填	类型	示例值	说明
token	是	String	CA1D905AC89ACDCA	第二步中获取到的access_token

# 响应说明：

正确时返回的json数据包如下（具体信息后续补充）：

不同身份类型用户的具体字段要求见用户字段说明。

{
    "errcode": 0,
    "card_number": "1604030126", // 学号
    "name": "evan1", // 姓名
    "identity_type": "1", // 身份类型，1为其他，2为学生，3为教职工，4为校友
    "grade": "2016", // 年级（需申请）
    "college": "人居环境工程学院", // 学院（需申请）
    "profession": " 工程造价", // 专业（需申请）
    "class": "1班", // 班级（需申请）
    "identity_title": "经理/总监/部长/本科生...", // 身份职称（需申请）
    "gender": 1, // 性别（需申请）
    "organization": [
        2,
        222,
        496
    ], // 组织架构（需申请）
    "campus": "东校区", // 校区（需申请）
    "dorm_number": "至善园", // 宿舍号（需申请）
    "physical_chip_number": "", // 物理芯片号（需申请）
    "physical_card_number": "", // 物理卡号（需申请）
    "nation": "汉族", // 民族（需申请）
    "birthday": "20020319", // 生日（需申请）
    "origin_place": "深圳市", // 生源地（需申请）
    "graduated_school": "小碧中学", // 毕业学校（需申请）
    "address": "广东省深圳市XXX", // 家庭住址（需申请）
    "contact_person": "", // 联系人（需申请）
    "contact_phone": "", // 联系人手机号（需申请）
    "email": "xxxxx@qq.com", // 邮箱（需申请）
    "id_card": "440XXXXXXXXXXXXXXX", // 身份证（需申请）
    "telephone": "137XXXXXXXX" // 手机号（需申请）
    "expire_at": "2019-12-31 12:00:00" // 有效期结束时间（需申请）
    "start_at":"2019-12-31 11:50:00" // 有效期开始时间（需申请）
    "qq": "12345678" // qq号（需申请）
}

参数	是否可空	说明
errcode	非空	返回码（0表示成功）
card_number	非空	学号
name	非空	姓名
identity_type	非空	身份类型，1为其他，2为学生，3为教职工，4为校友
grade	可空	年级（需申请）
college	可空	学院（需申请）
profession	可空	专业（需申请）
class	可空	班级（需申请）
identity_title	可空	身份职称（需申请）
gender	可空	性别（需申请）
organization	可空	组织架构（需申请）
campus	可空	校区（需申请）
dorm_number	可空	宿舍号（需申请）
physical_chip_number	可空	物理芯片号（需申请）
physical_card_number	可空	物理卡号（需申请）
nation	可空	民族（需申请）
birthday	可空	生日（需申请）
origin_place	可空	生源地（需申请）
graduated_school	可空	毕业学校（需申请）
address	可空	家庭住址（需申请）
contact_person	可空	联系人（需申请）
contact_phone	可空	联系人手机号（需申请）
email	可空	邮箱（需申请）
id_card	可空	身份证（需申请）
telephone	可空	手机号（需申请）
expire_at	可空	有效期结束时间（需申请）
start_at	可空	有效期开始时间（需申请）
qq	可空	qq号（需申请）