# 快速上手

## API 權限申請流程

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

<figure><img src="/files/rcgoIViQ9RunApgxekoc" 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 串接可能遇到例外狀況(如網路異常、停機)，建議串接時設計重送機制。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://104ha-docs.gitbook.io/104-ha-openapi/clients/prohrm/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.