# 開發應用程式或串接 Webhook

建立讓其他 Drime 使用者連結到自己帳戶的 OAuth 應用程式、接收 Webhook，並讓您的伺服器收到 Drime Sign 事件通知。

更新於：2026-10-19  
來源：https://drime.cloud/zh-tw/support/integrations-and-api/build-an-integration

若要在自己的帳戶上使用 Drime API，個人權杖就足夠了：請參閱[建立 API 權杖](https://drime.cloud/zh-tw/support/integrations-and-api/api-tokens)。若要開發讓其他 Drime 使用者連結到自己帳戶的應用程式，請建立 OAuth 應用程式：使用者會在 Drime 上核准您的應用程式，而應用程式永遠不會看到他們的密碼。

## 建立 OAuth 應用程式

任何已登入的使用者都可以在開發人員入口網站中建立應用程式：前往**我的應用程式**，然後按一下**建立應用程式**。

![開發人員入口網站的「建立應用程式」表單，顯示三種應用程式類型](https://drime.cloud/media/01M5AT6DMNDAVYH6SJW5CDQYFB/8439d64a4ecd-web-developers-create-application.png)

首先，選擇您要開發的類型：

| 選項 | 適用情況 |
| --- | --- |
| **網站或伺服器** | 您會取得一組密鑰，須保存在您的伺服器上。 |
| **桌面或行動應用程式** | 安裝在使用者的裝置上，因此沒有密鑰。 |
| **僅供自己使用的腳本** | 您自己執行的小工具。 |

接著，選擇應用程式需要存取的範圍：**專屬資料夾**（應用程式永遠只會看到一個在雲端硬碟中建立的資料夾）或**整個雲端硬碟**。

補充說明：

- 您最多可以建立 25 個應用程式。
- 新的應用程式最多可供 25 位使用者使用。若要開放給更多人，請使用**面向所有人開放**，然後按一下**提交審核**：Drime 會在 24 小時內回覆。
- 存取權杖的有效期為 1 小時，重新整理權杖則為 90 天。
- 第三方應用程式永遠無法存取 Vault。

**網站或伺服器**類型的應用程式，也可以在已連結的帳戶中有檔案建立或刪除時接收 Webhook。每則通知都會在 `X-Drime-Signature` 標頭中附上簽章。

## Drime Sign Webhook

在**設定** \> **開發人員** \> **Webhook**（**Drime Sign 事件的 HTTP 通知。**）中按一下**新增 Webhook**，即可在發生特定事件時通知您的伺服器，例如：

- 文件已傳送、已完成或遭到拒絕；
- 簽署者檢視、簽署或拒絕簽署文件；
- 範本已建立。

![「開發人員」設定中的「Webhook」區段，顯示「新增 Webhook」按鈕](https://drime.cloud/media/01M5AKQ8TWF4KP6TWB0GPD9RK7/f4d9572805b0-web-sign-webhooks.png)

每則通知都會以密鑰簽章（`X-Drime-Signature`，HMAC SHA-256）。傳送失敗的通知會在約 34 小時內重試最多 10 次。您可以使用**傳送測試**和**更換密鑰**，也可以查看**傳送記錄**。

## 在網站上嵌入簽署表單

在**設定** \> **開發人員** \> **嵌入**中，您可以使用 `<drime-sign-form>` 元件，讓訪客不必離開您的網站就能簽署文件。請在**允許的網域**中新增您的網域：如果沒有新增任何網域，嵌入功能就會停用。

## 後續步驟

- [建立 API 權杖](https://drime.cloud/zh-tw/support/integrations-and-api/api-tokens)
- [Rclone、Drime CLI 和 WebDAV](https://drime.cloud/zh-tw/support/integrations-and-api/rclone-cli-and-webdav)