第三方账号登录教育号接口

使用场景： 第三方平台登录教育号的应用。

请求方式： GET（HTTPS）

请求地址： https://sso.qq.com/pass/third_account_login

请求方法: [ GET ]

请求参数:

请求示例 https://sso.qq.com/pass/third_account_login?account_source=2c69c7aa42f001&appid=10000&code=xxxxxx

code换取access_token

接口说明：此接口返回的 access_token 用于完成登录态下发，查询用户信息，与 suite_access_token 和 corp_access_token 不同

请求地址: https://sso.qq.com/open/access_token

请求方法: [ GET, POST ]

请求参数:

请求示例:

https://sso.qq.com/open/access_token?appid=xxxx&secret=265b2b7&code=581879d8ac77948&redirect_uri=https://xxx.html&grant_type=authorization_code

返回结果:

{
  "code": 0,
  "msg": "请求成功",
  "requestid": "463b215ea1d466a8",
  "data": {
    "access_token": "a51kiS9ooVgQRfhVqLCrmTsj5kFGu1JZnKwyctgbQB.QxUJnHSmGLclVKyhgijlhXfXfdjELsfZ",
    "expires_in": 7200,
    "refresh_token": "38NpHr4Ax51wUedoST3HWKMb5BJp88pomd7Wz2p772P2SWJvD1geWKxjzC1dF816rsyBXgeJVG8Hnb6oaAK3yYTTDuLiztSwcf9vUUh.SmqTWjhtrOftpmLfNaKNsEjvFnvIvwMcliiYlBAdEEFEOpssxGrmzJRlqhPSVMBc"
  }
}

参数说明:

更新access_token

请求地址: https://sso.qq.com/open/refresh_token

请求方法: [ GET, POST ]

请求参数:

请求示例:

https://sso.qq.com/open/refresh_token?appid=xxxx&refresh_token=581879d8ac77948&grant_type=refresh_token

返回结果：

{
  "code": 0,
  "msg": "请求成功",
  "requestid": "102d02d392911261",
  "data": {
    "access_token": "G3eBvGPjgqJPf2hvszeyYgxUbVhVZh4E79.rujydCcdhtTZpKnkyrOTfrlNBhfJMElE",
    "expires_in": 7200,
    "refresh_token": "37QZ1UiTUsaxP7u6pq41CfcQRDg8gqcmexSyvo243HMjwCejASNZjqV8gfTMgkqpkRtXfhaMqfouUXnvD4EWtMW3noAp.kyshHAmwrjIrcDMjcuiLhLiSWdbksFxKuwPPAmbCxkIKGziQvmIXhPIUAHwJHMHf"
  }
}

参数说明:

查询用户信息

使用场景： 用户登录后，使用此接口可以查询到用户的信息，用于角色判定、资料展示。

是否需额外授权: 否

请求方式： [GET, POST]（HTTPS）

请求地址： https://oapi.epaas.qq.com/account/userinfo?access_token=ACCESS_TOKEN

参数说明：

返回结果：

{
  "errcode": 0,
  "errmsg": "ok",
  "user_name": "用户1",
  "appid": "10000",
  "role_id": 12,
  "sub_role_id": 1,
  "userid": "30000000",
  "corpid": 80000,
  "avatar": "https://smart20-1253364609.cos.ap-beijing.myqcloud.com/2021/202106/20210616/EWaAeXFz46b_yY7QwG.png",
  "corp_type": 4,
  "corp_name": "测试学校",
  "child_id": "20000000"
}

参数说明：

第三方平台需要实现的接口

获取access_token

使用场景： 由教育号调用

请求地址: https://{第三方后台接口域名}/access_token

请求方法: [ POST ]

请求参数：

{
  "appid": "20000",
  "secret": "xxxx",
  "code": "xxxx",
  "grant_type": "authorization_code"
}

返回结果:

{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "access_token": "a51kiS9ooVgQRfhVqLCrmTsj5kFGu1JZnKwyctgbQB.QxUJnHSmGLclVKyhgijlhXfXfdjELsfZ",
    "expires_in": 7200,
    "refresh_token": "38NpHr4Ax51wUedoST3HWKMb5BJp88pomd7Wz2p772P2SWJvD1geWKxjzC1dF816rsyBXgeJVG8Hnb6oaAK3yYTTDuLiztSwcf9vUUh.SmqTWjhtrOftpmLfNaKNsEjvFnvIvwMcliiYlBAdEEFEOpssxGrmzJRlqhPSVMBc"
  }
}

参数说明

获取用户信息

请求地址: https://{第三方后台接口域名}/userinfo?access_token={access_token}

请求方法: [ GET ]

请求参数:

返回结果:

{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "openid": "ed12312",
    "org_code": "123456",
    "org_name": "测试学校",
    "role_id": 12,
    "sub_role_id": 1,
    "name": "叶小宏",
    "user_number": "2009060406",
    "gender": "1",
    "mobile": "15900110011",
    "student_info": {
      "class_path": "/2021级/一班",
      "class_code": "/12434/2343"
    }
  }
}