# 应用调用学生身份认证
具体的认证流程如下:
# 第一步:跳转到腾讯微卡指定页面,获取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: 腾讯微卡提供给应用方作为授权认证的标识 (点击申请 (opens new window))
redirect_uri: 授权后重定向的回调链接地址,地址要进行urlencode(需在腾讯微卡填写安全域名)
授权成功后,页面会跳至回调地址并带上wxcode码
wxcode说明:wxcode作为换取用户id和基本信息的票据,每次认证带上的wxcode都不一样,并且每个wxcode只能使用一次,有效时间为5分钟。
# 第二步:通过wxcode换取网页授权access_token
请求方法:
请求类型:POST
请求地址:https://weixiao.qq.com/apps/school-auth/access-token
参数说明:
{
"app_key": APP_KEY, // 腾讯微卡授权唯一标识
"wxcode": CODE, // 第一步获取到的code
"app_secret": APP_SECRET
}
返回说明: 正确时返回的json数据包如下(具体信息后续补充):
{
"errcode": 0,
"access_token": "xxxx"
}
错误时返回:
{
"errcode": "6001",
"errmsg": "invalid code",
}
# 第三步:通过access_token换取用户基本信息
字段申请: 发送需要申请的字段到seasonyuan@tencent.com进行申请(邮件同时也抄送至lydiaxyang@tencent.com , lindayyang@tencent.com , ronniewan@tencent.com),申请时需要注明应用APPKEY、应用名称、及应用使用场景
请求方法:
请求类型:POST
请求地址:https://weixiao.qq.com/apps/school-auth/user-info
参数说明:
{
"token": "xxx", //第二步中获取到的access_token
}
返回说明: 正确时返回的json数据包如下(具体信息后续补充):
不同身份类型用户的具体字段要求见用户字段说明 (opens new window)。
{
"errcode": 0,
"card_number": "1604030126", // 学号
"name": "evan1", // 姓名
"identity_type": "1", // 身份类型,1为其他,2为学生,3为教职工,4为校友
"identity_type_child": "0", // 身份类型的小类(需申请)
"grade": "2016", // 年级(需申请)
"college": "人居环境工程学院", // 学院(需申请)
"profession": " 工程造价", // 专业(需申请)
"class": "1班", // 班级(需申请)
"identity_title": "经理/总监/部长/本科生...", // 身份职称(需申请)
"gender": 1, // 性别(需申请)
"organization": [
2,
222,
496
], // 组织架构(需申请)
"campus": "东校区", // 校区(需申请)
"employer":"XX研究所", // 工作单位(需申请)
"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", // 邮箱(需申请)
"card_type": "1", // 证件类型(需申请)
"id_card": "440XXXXXXXXXXXXXXX", // 证件号码(需申请)
"country": "CHN", // 国籍(需申请)
"telephone": "137XXXXXXXX" // 手机号(需申请)
"expire_at": "2019-12-31 12:00:00" // 有效期(需申请)
"qq": "12345678" // qq号(需申请)
}