# 应用调用学生身份认证

具体的认证流程如下:

# 第一步:跳转到腾讯微卡指定页面,获取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号(需申请)
}