# 员工变更

通过该事件订阅员工变更。

只有当应用拥有被改动字段的数据权限时，才会接收到事件。

# 事件

基本
事件类型 contact.user.updated
支持的应用类型 自建应用
权限要求 开启任一权限即可
以应用身份读取通讯录
以应用身份访问通讯录
字段权限要求 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请：
获取用户基本信息
获取用户 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 - -
 ∟new_object user_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"
  ∟ employee_no string 工号
字段权限要求（满足任一）：
获取用户组织架构信息
  ∟leave_time 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 字段描述
 ∟old_object user_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"
  ∟ employee_no string 工号
字段权限要求（满足任一）：
获取用户组织架构信息
  ∟leave_time 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":"9d0e0836-c178-44db-af04-b4c1be00639c",
        "tenant_key":"327ab1e8160c0b783kUZ",
        "event_type":"contact.user.updated",
        "create_time":"1675223417173",
        "app_id":"bli_nbwm9b2yt120a9ll",
        "token":"5559d6020ae64c42a7190e0b8e5f1f51"
    },
    "event":{
        "new_object":{
            "work_station":"北京",
            "leave_time":"2022-01-01 01:01:02",
            "gender":2,
            "avatar_key":"http://img.bosszhipin.com/v2/upload/ship/avatar/male-4.png",
            "open_id":"ou_0cf9b878fe6f56ad486ef3d68c790bbb",
            "icon":"http://img.bosszhipin.com/v2/upload/ship/avatar/male-4.png",
            "mobile":"12312341222",
            "lateral_user_ids":[
                "11111111392"
            ],
            "employee_no":"zWSpL1oqHztPVrld",
            "join_time":"2022-01-01 01:01:02",
            "department_ids":[
                "org05091245",
                "1KZerI5GhivqYwHn2"
            ],
            "employee_type":"PROBATIONARY",
            "participatework_time":"2022-01-01 01:01:02",
            "user_id":"zWSpL1oqHztPVrld",
            "union_id":"on_1a036c7ea57bb88ab8997333fbe9521a",
            "custom_attrs":[
                {
                    "fieldName":"db24318acfc24ab8965084d2504aafb3",
                    "fieldDesc":"佳佳测试",
                    "type":"DATE",
                    "fieldValue":"2023-01-24T16:00:01.000Z"
                }
            ],
            "name":"开放平台部分更新4",
            "nickname":"kai fang ping tai bu fen geng xin 4",
            "leader_user_id":"11111111287",
            "report_user_id":"11111111394",
            "job_title":"开发",
            "email":"123333333391@kanzhun.com",
            "status":{
                "is_activated":false,
                "is_resigned":false
            }
        },
        "old_object":{
            "work_station":"北京",
            "leave_time":"2022-01-01 01:01:02",
            "gender":2,
            "avatar_key":"http://img.bosszhipin.com/v2/upload/ship/avatar/male-4.png",
            "open_id":"ou_0cf9b878fe6f56ad486ef3d68c790bbb",
            "icon":"http://img.bosszhipin.com/v2/upload/ship/avatar/male-4.png",
            "mobile":"12312341222",
            "lateral_user_ids":[
                "11111111392"
            ],
            "employee_no":"zWSpL1oqHztPVrld",
            "join_time":"2022-01-01 01:01:02",
            "department_ids":[
                "org05091245",
                "1KZerI5GhivqYwHn2"
            ],
            "employee_type":"PROBATIONARY",
            "participatework_time":"2022-01-01 01:01:02",
            "user_id":"zWSpL1oqHztPVrld",
            "union_id":"on_1a036c7ea57bb88ab8997333fbe9521a",
            "name":"开放平台部分更新3",
            "nickname":"kai fang ping tai bu fen geng xin 3",
            "leader_user_id":"11111111287",
            "report_user_id":"11111111394",
            "job_title":"开发",
            "email":"123333333391@kanzhun.com",
            "status":{
                "is_activated":false,
                "is_resigned":false
            },
            "custom_attrs":[
            {
              "fieldName": "db24318acfc24ab8965084d2504aafb3",
              "fieldDesc": "佳佳测试",
              "type": "DATE",
              "fieldValue": "2023-01-24T16:00:01.000Z"
            }]
        }
    }
}
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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
最后更新于 : 2/8/2023, 11:22:22 AM

← 创建部门 →