Zoho People API 指南

Zoho People 是一家领先的人力资源解决方案提供商，致力于帮助企业自动化和简化人力资源管理。从优化核心人力资源流程，到支持时间和出勤管理，再到提升绩效管理和促进员工学习与发展，Zoho People 已为全球超过 4500 家企业提供了卓越的服务。通过 Zoho People API，企业可以轻松提取和访问员工数据，并将其与第三方应用程序（如 ATS、LMS、员工入职工具等）集成，实现信息的无缝交换。

Zoho People API 认证

Zoho People API 采用 OAuth 2.0 协议进行身份验证，确保数据安全性和用户隐私。通过授权码授权类型，用户可以在无需共享凭据的情况下，与应用程序共享特定数据。API 使用访问令牌提供安全的临时访问权限，应用程序通过该令牌与 Zoho People 进行交互。

OAuth 2.0 的优势包括：

• 用户可随时撤销应用程序的访问权限。
• 防止凭据泄露，即使客户端被黑客入侵，数据也能得到保护。
• 通过作用域限制，控制客户端对数据的访问范围。

Zoho People API 对象、数据模型与端点

在集成 Zoho People API 之前，开发者需要熟悉其对象、数据模型和端点。以下是一些关键概念和常用 API 示例。

表格 API

• 插入记录：

  https://people.zoho.com/people/api/forms///insertRecord?inputData=

• 更新记录：

  https://people.zoho.com/people/api/forms///updateRecord?inputData=&recordId=

• 获取记录：

  https://people.zoho.com/people/api/forms//getRecords?index=&limit=

• 按 ID 获取单条记录：

  https://people.zoho.com/people/api/forms//getRecordByID?recordId=

案例 API

• 添加案例：

  https://people.zoho.com/api/hrcases/addcase?categoryId=&subject=&description=

• 查看案例：

  https://people.zoho.com/api/hrcases/viewcase?recordId=

时间表 API

• 创建时间表：

  https://people.zoho.com/people/api/timetracker/createtimesheet?user=&timesheetName=&description=&fromDate=&toDate=

• 获取时间表详情：

  https://people.zoho.com/people/api/timetracker/gettimesheetdetails?timesheetId=

入职 API

• 触发入职流程：

  https://people.zoho.com/api//triggerOnboarding

休假 API

• 添加休假记录：

  https://people.zoho.com/people/api/forms///insertRecord?inputData=

• 获取休假报告：

  https://people.zoho.com/api/v2/leavetracker/reports/bookedAndBalance

出勤 API

• 批量导入出勤记录：

  https://people.zoho.com/people/api/attendance/bulkImport?data=

• 更新用户班次：

  https://people.zoho.com/people/api/attendance/updateUserShift?dateFormat=&empId=&shiftName=&fromDate=&toDate=

Zoho People API 使用案例

Zoho People API 提供了多种功能，帮助企业优化人力资源管理流程。以下是一些典型的使用场景：

• 快速入职：通过录取通知书管理、新员工门户和自定义工作流程，简化候选人入职流程。
• 考勤管理：基于云的考勤系统，支持生成详细报告，规范考勤记录，并实现远程打卡。
• 休假管理：提供即时访问员工休假历史、移动端休假申请和审批功能，支持多地点休假管理。
• 时间表管理：记录项目、任务和客户的时间分配，优化资源使用，并通过准确的时间日志快速生成发票。
• 排班管理：支持自动轮班、自定义日程表以及员工休息和津贴的跟踪与分析。
• 绩效管理：通过 360 度反馈系统和定制化评估方法，提升员工绩效。
• 案例管理：集中管理员工问题，跟踪状态，并通过知识库快速响应。

Zoho People API 常见问题解答

以下是一些常见问题及其解决方案：

• 如何处理 API 返回 HTTP 状态 400 的问题？
• 如何实现 Podio 与 Zoho People 的 Webhook 集成？
• 如何在 Postman 中测试 Zoho People 的出勤 API？
• 权限被拒绝时如何获取记录？
• 如何使用 VB.NET 解析 Zoho People 的 JSON 数据？
• 如何在 Deluge 中编写自定义函数以获取特定日期范围内的所有日期？
• 如何同步 Zoho People 与 Google Calendar API？

如何与 Zoho People API 集成

要将您的应用程序与 Zoho People API 集成，您需要以下条件：

1. 有效的 Zoho People 用户凭据。
2. 获取有效的 OAuth 认证令牌。

通过这些步骤，您可以安全地访问 Zoho People API 并实现与其他应用程序的无缝集成。

开始使用 Zoho People API

原文链接: https://www.getknit.dev/blog/zoho-people-api-guide