成员变动
使用场景:用于一个成员停职、离岗、其他变动的场景
需注意的是:这部分变动后成员是非正常状态成员,在普通的成员接口中查询不到,需要通过该变动成员相关接口获取
权限说明
权限项 | 说明 | 备注 |
---|---|---|
应用是否需要申请白名单 | 需要 | 申请方式:联系项目接口人申请 |
用户凭证 | 未支持 | |
机构凭证 | 支持 | 获取不到用户凭证的后台管理场景使用 |
请求方式: POST(HTTPS)
请求地址:https://oapi.epaas.qq.com/user/move
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证 |
Body参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
userids | []string | 是 | 变动人员ID列表,变动人员必须是普通教职工或教育局普通员工 |
reason | string | 是 | 退休原因 |
move_type | uint32 | 是 | 变动类型 1:退休 2:离岗 3:停职 4:其他变动 |
返回参数:
参数 | 类型 | 说明 |
---|---|---|
errcode | int32 | 返回码 |
errmsg | string | 对返回码的文本描述内容 |
请求示例:
POST https://oapi.epaas.qq.com/user/move?access_token=ACCESS_TOKEN
请求包体:
{
"userids": ["3724361204","3724348975"],
"reason": "学校老师停职",
"move_type": 2
}
返回示例:
{
"errcode": 0,
"errmsg": "ok"
}
变动成员迁回
使用场景:用于将一个变动成员恢复为正常成员,例如停职成员恢复职位等场景。
需注意的是:退休的教师不支持迁回
权限说明
权限项 | 说明 | 备注 |
---|---|---|
应用是否需要申请白名单 | 需要 | 申请方式:联系项目接口人申请 |
用户凭证 | 未支持 | |
机构凭证 | 支持 | 获取不到用户凭证的后台管理场景使用 |
请求方式: POST(HTTPS)
请求地址:https://oapi.epaas.qq.com/user/move_back
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证 |
Body参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
userid | string | 是 | 迁回人员ID,迁回人员必须是已变动的教职工 |
department_ids | []uint32 | 是 | 接收部门id列表 |
返回参数:
参数 | 类型 | 说明 |
---|---|---|
errcode | int32 | 返回码 |
errmsg | string | 对返回码的文本描述内容 |
请求示例:
POST https://oapi.epaas.qq.com/user/move_back?access_token=ACCESS_TOKEN
请求包体:
{
"userid": "3724361204",
"department_ids": [5383525]
}
返回示例:
{
"errcode": 0,
"errmsg": "ok"
}
获取变动成员列表
使用场景:用于查询机构内停职、离岗、其他变动的成员列表;
这部分成员是非正常状态成员,在普通的成员接口中查询不到,需要通过该特定接口获取
需注意的是:退休的教师不在该列表
权限说明
权限项 | 说明 | 备注 |
---|---|---|
应用是否需要申请白名单 | 不需要 | 申请方式:联系项目接口人申请 |
用户凭证 | 未支持 | |
机构凭证 | 支持 | 获取不到用户凭证的后台管理场景使用 |
请求方式: GET(HTTPS)
请求地址: https://oapi.epaas.qq.com/user/move_list
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证 |
move_type | uint32 | 否 | 变动类型 0: 2/3/4的集合 2:离岗 3:停职 4:其他变动 |
page_index | uint32 | 否 | 第几页 默认:1 |
page_size | uint32 | 否 | 每页数量 默认:30 |
返回参数:
参数 | 类型 | 说明 |
---|---|---|
errcode | int32 | 返回码 |
errmsg | string | 对返回码的文本描述内容 |
total | uint32 | 总数 |
data_list | 数据列表 | |
data_list.userid | string | 用户id |
data_list.name | string | 用户名 |
data_list.user_no | string | 职工号 |
data_list.move_type | uint32 | 变动类型 2:离岗 3:停职 4:其他变动 |
data_list.move_type_name | string | 变动名称 |
请求示例:
GET https://oapi.epaas.qq.com/user/move_list?access_token=ACCESS_TOKEN&move_type=0&page_index=1&page_size=30
请求包体:
返回示例:
{
"errmsg": "ok",
"errcode": 0,
"data_list": [
{
"id": 1188,
"userid": "3724348906",
"name": "易老师3",
"user_no": "65412387888",
"move_type": 2,
"move_type_name": "已离岗"
}
],
"total": 1
}
检索变动成员
使用场景: 搜索教职工变动列表
需注意的是:退休的教师不在该列表
权限说明
权限项 | 说明 | 备注 |
---|---|---|
应用是否需要申请白名单 | 需要 | 申请方式:联系项目接口人申请 |
用户凭证 | 未支持 | |
机构凭证 | 支持 | 获取不到用户凭证的后台管理场景使用 |
请求方式: POST(HTTPS)
请求地址: https://oapi.epaas.qq.com/user/search_move
Query参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
phone | string | 否 | 教师手机号(精确搜索) |
name | string | 否 | 姓名(模糊搜索) |
user_no | string | 否 | 职工号 |
move_type_list | []string | 否 | 变更类型列表。1:退休 2:离岗 3:停职 4:其他 当数组为空时,拉取全部 |
page_index | uint32 | 否 | 第几页 默认:1 |
page_size | uint32 | 否 | 每页数量 默认:30 |
返回示例:
参数 | 类型 | 说明 |
---|---|---|
errcode | int32 | 返回码 |
errmsg | string | 对返回码的文本描述内容 |
total | Uint64 | 总数 |
data_list | 数据列表 | |
data_list.userid | string | 用户id |
data_list.name | string | 用户名 |
data_list.user_no | string | 职工号 |
data_list.move_type | uint32 | 变动类型 1:退休 2:离岗 3:停职 4:其他变动 |
请求示例:
POST https://oapi.epaas.qq.com/user/search_move?access_token=ACCESS_TOKEN
请求包体:
{
"name": "",
"user_no": "",
"move_type_list": [2,3,4],
"page_index": 1,
"page_size": 20
}
返回示例:
{
"errmsg": "ok",
"errcode": 0,
"data_list": [
{
"id": 1188,
"userid": "3724348906",
"name": "易老师3",
"user_no": "65412387888",
"move_type": 2
}
],
"total": 1
}
获取变动成员变动记录
使用场景: 获取某个变动成员的历史变动记录
权限说明
权限项 | 说明 | 备注 |
---|---|---|
应用是否需要申请白名单 | 不需要 | 申请方式:联系项目接口人申请 |
用户凭证 | 未支持 | |
机构凭证 | 支持 | 获取不到用户凭证的后台管理场景使用 |
请求方式: GET(HTTPS)
请求地址: https://oapi.epaas.qq.com/user/move_log
Query参数 :
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证,使用corp_access_token,由/service/get_corp_token获得 |
userid | string | 是 | 用户id |
返回示例:
参数 | 类型 | 说明 |
---|---|---|
errcode | int32 | 返回码 |
errmsg | string | 对返回码的文本描述内容 |
data_list | 数据列表 | |
data_list.move_time | string | 变动时间 |
data_list.reason | string | 原因 |
data_list.move_type | uint32 | 变动类型 1:退休 2:离岗 3:停职 4:其他变动 |
data_list.move_type_name | string | 变动名称 |
data_list.depart_names | []string | 教师部门 |
请求示例:
GET https://oapi.epaas.qq.com/user/move_log?access_token=ACCESS_TOKEN&userid=USERID
请求包体:
返回示例:
{
"errmsg": "ok",
"errcode": 0,
"data_list": [
{
"move_time": "2021-03-19",
"reason": "测试学校退休老师",
"move_type": 2,
"move_type_name": "离岗",
"depart_names": [
"理学部/心理学院-普通教师"
]
},
{
"move_time": "2021-03-19",
"reason": "测试学校退休老师",
"move_type": 3,
"move_type_name": "停职",
"depart_names": [
"理学部/心理学院-普通教师"
]
},
{
"move_time": "2021-03-19",
"reason": "回迁",
"move_type": 5,
"move_type_name": "回迁",
"depart_names": [
"理学部/心理学院-普通教师"
]
}
]
}
获取离岗教师手机号
使用场景: 获取离岗教师手机号
需注意的是:不包含退休的教师
权限说明
权限项 | 说明 | 备注 |
---|---|---|
应用是否需要申请白名单 | 需要 | 申请方式:联系项目接口人申请 |
用户凭证 | 未支持 | |
机构凭证 | 支持 | 获取不到用户凭证的后台管理场景使用 |
请求方式: POST(HTTPS)
请求地址: https://oapi.epaas.qq.com/user/phone/batch_get_move
Query参数 :
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
userids | []string | 是 | 迁回人员ID,迁回人员必须是已变动的教职工 |
返回示例:
参数 | 类型 | 说明 |
---|---|---|
errcode | int32 | 返回码 |
errmsg | string | 对返回码的文本描述内容 |
userlist | 用户数组 | |
userlist.userid | string | 用户id |
userlist.phone | string | 用户手机号 |
请求示例:
POST https://oapi.epaas.qq.com/user/phone/batch_get_move?access_token=ACCESS_TOKEN
请求包体:
{
"userids": ["30046307", "30046308"]
}
{
"errcode": 0,
"errmsg": "ok",
"userlist": [
{
"userid": "1",
"phone": "18888888888"
}
]
}