绑定
使用场景：用于绑定教育号帐号和第三方帐号
调用权限：
需要额外授权：应用申请白名单 + 机构白名单
支持机构票据
请求方式： POST（HTTPS）
请求地址： https://test-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://test-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://test-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列表 |
| appid | 否 | 默认取登录态里面的应用，可以查询指定应用(在教育号账号源里面配置的)绑定的openid |
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"data_list": [
{
"userid": "10101",
"openid": "THIRD00001"
},
{
"userid": "10102",
"openid": "THIRD00002"
},
{
"userid": "10103",
"openid": ""
}
}
参数说明：
| 参数 | 说明 |
|---|---|
| data_list | 返回学生信息列表 |
| data_list.userid | 教育号用户id |
| data_list.openid | 第三方平台openid，查询不到返回空字符串 |