開發應用程式或串接 Webhook
建立讓其他 Drime 使用者連結到自己帳戶的 OAuth 應用程式、接收 Webhook,並讓您的伺服器收到 Drime Sign 事件通知。
若要在自己的帳戶上使用 Drime API,個人權杖就足夠了:請參閱建立 API 權杖。若要開發讓其他 Drime 使用者連結到自己帳戶的應用程式,請建立 OAuth 應用程式:使用者會在 Drime 上核准您的應用程式,而應用程式永遠不會看到他們的密碼。
#建立 OAuth 應用程式
任何已登入的使用者都可以在開發人員入口網站中建立應用程式:前往我的應用程式,然後按一下建立應用程式。

首先,選擇您要開發的類型:
選項 | 適用情況 |
|---|---|
網站或伺服器 | 您會取得一組密鑰,須保存在您的伺服器上。 |
桌面或行動應用程式 | 安裝在使用者的裝置上,因此沒有密鑰。 |
僅供自己使用的腳本 | 您自己執行的小工具。 |
接著,選擇應用程式需要存取的範圍:專屬資料夾(應用程式永遠只會看到一個在雲端硬碟中建立的資料夾)或整個雲端硬碟。
補充說明:
您最多可以建立 25 個應用程式。
新的應用程式最多可供 25 位使用者使用。若要開放給更多人,請使用面向所有人開放,然後按一下提交審核:Drime 會在 24 小時內回覆。
存取權杖的有效期為 1 小時,重新整理權杖則為 90 天。
第三方應用程式永遠無法存取 Vault。
網站或伺服器類型的應用程式,也可以在已連結的帳戶中有檔案建立或刪除時接收 Webhook。每則通知都會在 X-Drime-Signature 標頭中附上簽章。
#Drime Sign Webhook
在設定 > 開發人員 > Webhook(Drime Sign 事件的 HTTP 通知。)中按一下新增 Webhook,即可在發生特定事件時通知您的伺服器,例如:
文件已傳送、已完成或遭到拒絕;
簽署者檢視、簽署或拒絕簽署文件;
範本已建立。

每則通知都會以密鑰簽章(X-Drime-Signature,HMAC SHA-256)。傳送失敗的通知會在約 34 小時內重試最多 10 次。您可以使用傳送測試和更換密鑰,也可以查看傳送記錄。
#在網站上嵌入簽署表單
在設定 > 開發人員 > 嵌入中,您可以使用 <drime-sign-form> 元件,讓訪客不必離開您的網站就能簽署文件。請在允許的網域中新增您的網域:如果沒有新增任何網域,嵌入功能就會停用。
#後續步驟
這篇文章有幫助嗎?