# 员工离职

通过该事件订阅员工离职


注意事项:

  • 在事件发生时,开放平台会根据应用当前有的字段权限进行过滤后推送
  • 在事件发生时,开放平台会根据应用当前通讯录权限进行过滤后推送

# 事件

基本
事件类型 contact.user.deleted
支持的应用类型 自建应用
权限要求 以应用身份读取通讯录
字段权限要求 该接口返回体中存在下列敏感字段,仅当开启对应的权限后才会返回;如果无需获取这些字段,则不建议申请:
获取用户基本信息
获取用户 user_id
获取用户邮箱
获取用户性别
获取用户手机号
获取用户雇佣信息
获取用户组织架构信息

# 事件体

名称 类型 描述
header event_header 事件头
 ∟ event_id string 事件 ID
 ∟ event_type string 事件类型
 ∟ create_time string 事件创建时间戳(单位:毫秒)
 ∟ token string 事件 Token
 ∟ app_id string 应用 ID
 ∟ tenant_key string 租户 Key
event - -
 ∟ open_id string 开放平台唯一Id,标识一个用户在某个应用中的身份
 ∟ union_id string 标识一个用户在某个应用开发商下的身份
 ∟ user_id string 租户内用户的唯一标识,用户的user_id
字段权限要求
获取用户 user_id(仅自建应用)
 ∟ name string 用户名
字段权限要求(满足任一)
获取用户基本信息
 ∟ nickname string 别名
字段权限要求(满足任一)
获取用户基本信息
 ∟ email string 邮箱。
字段权限要求
获取用户邮箱信息
 ∟ mobile string 手机号,在本企业内不可重复。
字段权限要求
获取用户手机号
 ∟ gender int 性别
可选值有
* 0:保密
* 1:男
* 2:女
字段权限要求(满足任一)
获取用户性别
 ∟ avatar_key string 用户头像信息
字段权限要求(满足任一)
获取用户基本信息
 ∟ status user_status 用户状态
字段权限要求(满足任一)
获取用户雇佣信息
  ∟is_resigned boolean 是否离职
  ∟is_activated boolean 是否激活
 ∟department_ids string[] 离职前用户所属部门的ID列表,一个用户可属于多个部门。
字段权限要求(满足任一)
获取部门基础信息
 ∟ leader_user_id string 离职前用户的直接主管的用户ID,
字段权限要求(满足任一)
获取用户 user_id
 ∟ report_user_id string 离职前汇报人userId。
字段权限要求(满足任一)
获取用户 user_id
 ∟lateral_user_ids string[] 次级汇报人Id
 ∟ job_title string 职务
字段权限要求(满足任一)
获取用户组织架构信息
 ∟ join_time string 入职时间
示例值:"2022-01-01 00:00:00"
 ∟leave_time string 离职时间
 ∟ employee_no string 工号
字段权限要求(满足任一)
获取用户组织架构信息
 ∟participatework_time string 参加工作时间
 ∟employee_type string 员工类型
可选值有
* REGULAR:正式
* PROBATIONARY:试用
 ∟work_station string 工位
 ∟custom_attrs custom_attr[] 自定义字段
  ∟field_name string 字段名称
  ∟field_value string 字段值
  ∟type string 字段类型
可选值有
* TEXT:文本
* WEB:网页
* DOWN_SINGLE:下拉单选
* DOWN_MULTIPLE:下拉多选
* DATE:日期
* DATE_INTER:日期区间
* STAFF_SINGLE:人员单选
* STAFF_MULTIPLE:人员多选
* DEPT_SINGLE:部门单选
* DEPT_MULTIPLE:部门多选
  ∟field_desc string 字段描述

# 事件体示例

{
    "header": {
        "event_id": "bbcce6e9-6ba4-4031-9b3c-8e610f3e0b73",
        "event_type": "contact.user.deleted",
        "create_time": "1662444442165",
        "token": "8c8cc37f29b34defb4bc9912167747a4",
        "app_id": "bli_sm8pxsvuwjsudhta",
        "tenant_key": "e33ed0f6204318233nR9"
    },
    "event": {
      "work_station":"",
      "leave_time":"2023-02-01 14:20:30",
      "gender":1,
      "avatar_key":"http://img.bosszhipin.com/v2/upload/ship/avatar/male-0.png",
      "open_id":"ou_b7983d974e6b35fb49139f318c42b1a5",
      "icon":"http://img.bosszhipin.com/v2/upload/ship/avatar/male-0.png",
      "mobile":"12312341238",
      "lateral_user_ids":[
        "11111111392"
      ],
      "employee_no":"96967",
      "join_time":"2022-01-01 00:00:00",
      "department_ids":[
        "org09071453"
      ],
      "employee_type":"REGULAR",
      "participatework_time":"2022-01-01 00:00:00",
      "user_id":"96967",
      "union_id":"on_a1a25584b4440313b6db036e154190ed",
      "custom_attrs":[
        {
          "fieldName":"db24318acfc24ab8965084d2504aafb3",
          "fieldDesc":"佳佳测试",
          "type":"DATE",
          "fieldValue":"2023-01-24T16:00:00.000Z"
        }
      ],
      "name":"开放平台新建用户",
      "nickname":"kai fang ping tai xin jian yong hu",
      "leader_user_id":"7759",
      "report_user_id":"11111111392",
      "job_title":"测试",
      "email":"1233333@kanzhun.com",
      "status":{
        "is_activated":false,
        "is_resigned":true
      }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
最后更新于 : 2/1/2023, 4:25:18 PM