账号互通是指将教育号侧账号和第三方账号绑定,已实现互联互通的场景。
需要注意的是,每个账号只能绑定一个第三方账号;
第三方账号绑定
绑定
使用场景:用于绑定教育号账号和第三方账号
调用权限:
需要额外授权:应用申请白名单 + 机构白名单
支持机构票据
请求方式: 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 | 第三方平台额外字段,查询不到返回空字符串 |