钉钉自建应用如何查询离职员工详情？像获取unionid，jobnumber这些信息。

要通过钉钉自建应用查询离职员工的详情（如 unionid、jobnumber 等信息），需要结合钉钉开放平台的能力和企业内部的权限配置来实现。以下是详细的操作步骤和说明：

1. 配置钉钉自建应用并获取必要权限

在钉钉开放平台中创建自建应用，并确保该应用具备查询员工信息的权限。

操作步骤：

1. 创建钉钉内部应用：

   • 登录钉钉开放平台，进入“应用开发”页面。
   • 单击“创建应用”，填写应用名称、描述等基本信息，完成创建。

2. 配置所需权限：

   • 在应用详情页面，选择左侧导航栏的“开发配置 > 权限管理”。
   • 勾选以下权限：
     • 通讯录个人信息读权限（个人权限）。
     • 通讯录管理全部权限（通讯录管理）。
   • 完成权限申请后，确保权限范围覆盖所有员工或目标部门。

3. 获取应用凭证：

   • 在“基础信息 > 凭证与基础信息”页面，记录 ClientID 和 ClientSecret，用于后续接口调用。

2. 调用钉钉开放API查询员工信息

通过钉钉提供的开放API，可以查询员工的详细信息，包括在职和离职员工的 unionid、jobnumber 等字段。

关键API及参数：

• API名称：/topapi/v2/user/get
• 功能：根据用户ID（userid）获取员工详细信息。
• 请求方式：POST
• 请求地址：https://oapi.dingtalk.com/topapi/v2/user/get?access_token=ACCESS_TOKEN

请求参数：

返回结果：

成功调用后，返回的JSON数据中包含以下关键字段： | 字段名 | 类型 | 说明 | |--------------|--------|-------------------------------| | unionid | String | 员工在钉钉企业中的唯一ID | | jobnumber | String | 员工工号 | | name | String | 员工姓名 | | department | Array | 员工所属部门ID列表 | | status | Number | 员工状态（1表示在职，2表示离职）|

注意事项：

• 离职员工查询：通过 status 字段判断员工是否离职（值为2表示离职）。
• 权限限制：确保应用已获得“通讯录管理全部权限”，否则无法查询离职员工信息。

3. 获取Access Token

调用钉钉API前，需先获取 access_token，这是调用所有API的必要凭证。

API名称：/gettoken

请求方式：GET

请求地址：https://oapi.dingtalk.com/gettoken?appkey=APPKEY&appsecret=APPSECRET

请求参数：

返回结果：

成功调用后，返回的JSON数据中包含 access_token，有效期为7200秒。

4. 查询离职员工的完整流程

以下是完整的操作流程：

1. 获取Access Token：

   • 使用 ClientID 和 ClientSecret 调用 /gettoken 接口，获取 access_token。

2. 查询员工信息：

   • 使用 access_token 和目标员工的 userid 调用 /topapi/v2/user/get 接口。
   • 检查返回结果中的 status 字段，确认员工是否离职。

3. 批量查询员工信息（可选）：

   • 如果需要批量查询员工信息，可以使用 /topapi/v2/user/list 接口，按部门ID分页获取员工列表。
   • 过滤出 status=2 的员工，提取其 unionid 和 jobnumber 等信息。

5. 注意事项

• 权限管理：确保应用已获得“通讯录管理全部权限”，否则无法查询离职员工信息。
• 数据隐私：离职员工的信息可能涉及敏感数据，请妥善保管并遵守相关法律法规。
• 接口调用频率：钉钉API有调用频率限制，请合理设计调用逻辑以避免触发限制。

通过上述步骤，您可以成功查询离职员工的 unionid、jobnumber 等详细信息。如果需要进一步处理这些数据，可以将其存储到企业内部系统或进行其他业务逻辑处理。