钉钉如何通过钉钉开放平台api获取员工离职信息，除了部门信息，还需要离职时的岗位吗？

要通过钉钉开放平台API获取员工离职信息（包括部门信息和离职时的岗位），可以按照以下步骤操作：

1. 前提条件

在开始之前，请确保满足以下条件： - 您已注册并登录钉钉开放平台。 - 您拥有企业管理员权限。 - 已创建一个钉钉应用，并获取了CorpId、AppKey和AppSecret。

2. 配置事件订阅

为了获取员工离职信息，需要配置钉钉的事件订阅功能。以下是具体步骤：

2.1 开启事件订阅

1. 登录钉钉开放平台，进入目标应用的管理页面。
2. 在左侧导航栏中，选择开发配置 > 事件订阅。
3. 在事件订阅页面，启用以下事件：
   • 通讯录用户离职：当员工离职时触发该事件。
4. 配置以下参数：
   • 加密aes_key：用于解密事件推送数据。
   • 加密token：用于验证事件推送的合法性。
5. 设置请求网址（即回调URL），该地址将接收钉钉推送的离职事件数据。

2.2 验证事件订阅

• 确保您的服务器能够正确接收并解析钉钉推送的事件数据。
• 测试事件订阅是否正常工作，可以通过模拟离职事件进行验证。

3. 获取离职员工详细信息

当员工离职事件触发后，钉钉会向您配置的回调URL推送离职员工的基本信息（如userid）。为了获取更详细的离职信息（如部门信息和岗位信息），需要调用以下API：

3.1 调用“获取用户详情”API

• 接口名称：/user/get
• 功能描述：根据userid获取员工的详细信息，包括部门ID和岗位信息。
• 请求参数：

  {
  "access_token": "your_access_token",
  "userid": "离职员工的userid"
  }
  

• 返回结果：

  {
  "userid": "zhangsan",
  "name": "张三",
  "department": [1, 2], // 员工所属部门ID列表
  "position": "开发工程师", // 员工岗位信息
  "status": 2 // 状态：2表示离职
  }
  

3.2 调用“获取部门详情”API

• 接口名称：/department/get
• 功能描述：根据部门ID获取部门的详细信息。
• 请求参数：

  {
  "access_token": "your_access_token",
  "id": "部门ID"
  }
  

• 返回结果：

  {
  "id": 1,
  "name": "技术部",
  "parentid": 0,
  "order": 10
  }
  

4. 数据处理与存储

• 将从API获取的离职员工信息（包括部门和岗位）存储到您的系统中。
• 如果需要进一步分析或展示，可以将数据导出为表格或其他格式。

5. 注意事项

• 权限配置：确保您的应用已开通以下权限：
  • 通讯录个人信息读权限
  • 通讯录部门信息读权限
  • 成员信息读权限
• 数据安全：离职信息属于敏感数据，请确保数据传输和存储的安全性。
• 事件订阅稳定性：确保回调URL的服务器稳定运行，避免因网络问题导致事件丢失。

通过以上步骤，您可以成功获取员工离职时的部门信息和岗位信息，并将其集成到您的系统中。