# 快速上手

## API 權限申請流程

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

<figure><img src="https://1470294451-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtWgkeITsy3LpiZcJRWJC%2Fuploads%2FXTTSBTPFBlEV0NYfnNyH%2Fimage.png?alt=media&#x26;token=3b9fff23-19db-42fa-911e-8d7eaf37984b" alt="" width="522"><figcaption></figcaption></figure>

### 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](https://pro.104.com.tw/hrmapi/docs/index.html#api-Authentication-%E5%8F%96%E5%BE%97access_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 串接可能遇到例外狀況(如網路異常、停機)，建議串接時設計重送機制。