API Service 範本
最後更新： 4 Jul 2026
選用官方 IT 套件—API Service 結構化欄位。
此範本是什麼
API Service 範本用於機器對機器憑證用的 API 金鑰、權杖與 Webhook 端點。於 設定 → 分類範本 → 基礎設施與 IT 啟用。
| 分類 slug | api-service |
| 套件 | 選用官方 — nt2-template-api-service |
| 方案 | 免費 |
何時使用（與何時不用）
適合情境
- 測試與正式環境的 REST／GraphQL API 金鑰
- 與人類登入密碼分開存放的 Webhook 簽章密鑰
- 每個廠商或微服務端點各一項目
請改用其他範本
| 情境 | 較適合的範本 |
|---|---|
| 人員入口網站登入 | Credential |
| 主機 SSH 金鑰對 | SSH Key |
| 非結構化運維筆記 | Secure Note |
日常流程
- 於啟用分類範本套件 → 基礎設施與 IT 啟用 API Service。
- 依環境（prod／staging）各建一項，並用 environment 與保管箱標籤分類。
- 輪替憑證時以 30 秒自動清除 複製 API key。
欄位一覽
| 欄位 | 填什麼 | 敏感？ |
|---|---|---|
| Title | Title | 否 |
| Service name | Service name | 否 |
| Endpoint URL | Endpoint URL | 否 |
| API key | API key | 是 |
| Webhook URL | Webhook URL | 否 |
| Environment | Environment | 否 |
| Notes | Notes | 否 |
你需要什麼
| 方案 | 免費 |
| 保管箱狀態 | 已解鎖 |
| 網路 | 首次成功載入後可離線 |
| 功能開關 | API Service 套件已啟用—見啟用分類範本套件 |
步驟
- 解鎖保管箱，開啟 設定 → 一般 → 分類範本。
- 於 基礎設施與 IT 將 API Service 切換為 開啟。
- 開啟 資產 → 新增資產 → API Service。
- 填寫必填欄位並 儲存。
提示與常見錯誤
- 先啟用套件—API Service 非核心內建。
- 勿將密鑰貼進 Secure Note—會失去遮罩、驗證與共用封鎖。
- 複製密鑰後剪貼簿 30 秒自動清除—請盡快貼上。