快速上手

Quick Start

API 權限申請流程

104 企業大師提供打卡資料串接功能，若您是企業大師的客戶，需要串接卡鐘系統的打卡資料，請參考以下 API 權限申請流程。

Step1：申請 API Key 權限

1. 登入 104 企業大師管理後台。

2. 依序前往：出勤／打卡／打卡管理／打卡串接

3. 同意使用規範，並點擊【我要申請API KEY權限】 向 104 進行申請作業。

前往：請人資管理系統 - 系統管理員，向客服人員申請權限，客服人員於 5 個工作天內會寄發檔案，內容含有 client_id、client_secret，可供 Step2 使用

Step2：HR 收到 API Key 權限

1. 信件附檔解壓縮密碼為公司統編，統編少於8碼請在前面補 0 (例如：00123456)

2. 104信函中，您會獲取 【ID】 及 【Secret】。

3. API文件：https://pro.104.com.tw/hrmapi/docs/index.html

※ 請 HR 將上述「2」與「3」資訊，交付貴公司IT人員，以利後續API串接進行。

Step3：開發 API 串接相關應用

1. 將收到的 【ID】 及 【Secret】 透過 取得 Access token，取得回傳值"access_token"的值

2. 將取得的 access token，加進 header 的 authorization 屬性，使用 Bearer 驗證方式，即可順利發送需求

3. 若您是企業大師客戶，由公司 IT 自行開發串接程式，請使用： 1.0/hrmapi/external/transferCard 打卡資料寫入

API 使用注意事項

1. access token 時效為 1 小時，過期後須重取。

2. 每秒最多 30 次。

3. API 串接可能遇到例外狀況(如網路異常、停機)，建議串接時設計重送機制。