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