成员变动

使用场景:用于一个成员停职、离岗、其他变动的场景

需注意的是:这部分变动后成员是非正常状态成员,在普通的成员接口中查询不到,需要通过该变动成员相关接口获取

权限说明

权限项 说明 备注
应用是否需要申请白名单 需要 申请方式:联系项目接口人申请
用户凭证 未支持
机构凭证 支持 获取不到用户凭证的后台管理场景使用

请求方式: POST(HTTPS

请求地址:https://test-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://test-oapi.epaas.qq.com/user/move?access_token=ACCESS_TOKEN

请求包体:

{
    "userids": ["3724361204","3724348975"], 
    "reason": "学校老师停职", 
    "move_type": 2
}

返回示例:

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

变动成员迁回

使用场景:用于将一个变动成员恢复为正常成员,例如停职成员恢复职位等场景。

需注意的是:退休的教师不支持迁回

权限说明

权限项 说明 备注
应用是否需要申请白名单 需要 申请方式:联系项目接口人申请
用户凭证 未支持
机构凭证 支持 获取不到用户凭证的后台管理场景使用

请求方式: POST(HTTPS

请求地址:https://test-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://test-oapi.epaas.qq.com/user/move_back?access_token=ACCESS_TOKEN

请求包体:

{
    "userid": "3724361204", 
    "department_ids": [5383525]
}

返回示例:

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

获取变动成员列表

使用场景:用于查询机构内停职、离岗、其他变动的成员列表;

这部分成员是非正常状态成员,在普通的成员接口中查询不到,需要通过该特定接口获取

需注意的是:退休的教师不在该列表

权限说明

权限项 说明 备注
应用是否需要申请白名单 不需要 申请方式:联系项目接口人申请
用户凭证 未支持
机构凭证 支持 获取不到用户凭证的后台管理场景使用

请求方式: GET(HTTPS

请求地址: https://test-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://test-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://test-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://test-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://test-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://test-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://test-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://test-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"
      }
    ]
}
© 1998 - 2021 Tencent Inc. All Rights Reserved all right reserved,powered by ePaaS.更新时间: 2024-08-22 10:14:39

results matching ""

    No results matching ""

    results matching ""

      No results matching ""