账号互通是指将教育号侧账号和第三方账号绑定,已实现互联互通的场景。

需要注意的是,每个账号只能绑定一个第三方账号;

第三方账号绑定

绑定

使用场景:用于绑定教育号账号和第三方账号

调用权限:

  • 需要额外授权:应用申请白名单 + 机构白名单

  • 支持机构票据

请求方式: POST(HTTPS

请求地址: https://oapi.epaas.qq.com/third_account/bind?access_token=ACCESS_TOKEN

请求包体

 {
    "userid": "10101",
      "openid": "THIRD00001"
 }

参数说明 :

参数 必须 说明
access_token 调用接口凭证,使用corp_access_token,由/service/get_corp_token获得
userid 教育号用户id
openid 第三方平台openid
force 是否强制绑定;true:强制覆盖绑定关系,false:若userid已存在绑定关系则返回失败

返回结果:

{
   "errcode": 0,
   "errmsg": "ok"
}

参数说明:

参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容

批量绑定

使用场景:用于批量绑定教育号账号和第三方账号

调用权限:

  • 需要额外授权:应用申请白名单 + 机构白名单

  • 支持机构票据

请求方式: POST(HTTPS

请求地址: https://oapi.epaas.qq.com/third_account/batch_bind?access_token=ACCESS_TOKEN

请求包体

 {
    "userid": "10101",
      "data_list": [
      {
        "openid": "test_1",
        "extend": "{\"depart\":1}"
      }
    ]
 }

参数说明 :

参数 必须 说明
access_token 调用接口凭证,使用corp_access_token,由/service/get_corp_token获得
userid 教育号用户id
data_list 第三方用户信息列表
data_list.openid 第三方平台openid
data_list.extend 第三方平台额外字段

返回结果:

{
   "errcode": 0,
   "errmsg": "ok"
}

参数说明:

参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容

解绑

使用场景: 用于解绑教育号账号和第三方账号的绑定关系

调用权限:

  • 需要额外授权:应用申请白名单 + 机构白名单

  • 支持机构票据

请求方式: POST(HTTPS

请求地址: https://oapi.epaas.qq.com/third_account/unbind?access_token=ACCESS_TOKEN

请求包体

 {
    "userid": "10101",
    "openid": "THIRD00001"
 }

参数说明 :

参数 必须 说明
access_token 调用接口凭证,使用corp_access_token,由/service/get_corp_token获得
userid 教育号用户id
openid 第三方平台openid

备注:为避免因参数错误导致的解绑不符合预期,解绑场景要求userid和openid都必须填写正确

返回结果:

{
   "errcode": 0,
   "errmsg": "ok"
}

参数说明:

参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容

查询

使用场景: 用于查询教育号账号和第三方账号的绑定关系

调用权限:

  • 需要额外授权:应用申请白名单 + 机构白名单

  • 支持机构票据

请求方式: POST(HTTPS

请求地址: https://oapi.epaas.qq.com/third_account/batch_get?access_token=ACCESS_TOKEN

请求包体

 {
    "userids": ["10101","10103","10103"]
 }

参数说明 :

参数 必须 说明
access_token 调用接口凭证,使用corp_access_token,由/service/get_corp_token获得
userids 教育号用户id列表

返回结果:

{
   "errcode": 0,
   "errmsg": "ok",
   "data_list": [
       {
           "userid": "10101",
           "openid": "THIRD00001",
           "extend": "{\"depart\":1}"
       },
       {
           "userid": "10102",
           "openid": "THIRD00002",
           "extend": "{\"depart\":2}"
       },
       {
           "userid": "10103",
           "openid": "",
           "extend": "{\"depart\":3}"
       }
   ]
}

参数说明:

参数 说明
data_list 返回第三方用户信息列表
data_list.userid 教育号用户id
data_list.openid 第三方平台openid,查询不到返回空字符串
data_list.extend 第三方平台额外字段,查询不到返回空字符串

results matching ""

    No results matching ""

    results matching ""

      No results matching ""