跳至主要內容
說明中心

類別

搜尋說明中心Ctrl K
本頁內容

開發應用程式或串接 Webhook

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

更新於 Web

若要在自己的帳戶上使用 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,即可在發生特定事件時通知您的伺服器,例如:

  • 文件已傳送、已完成或遭到拒絕;

  • 簽署者檢視、簽署或拒絕簽署文件;

  • 範本已建立。

「開發人員」設定中的「Webhook」區段,顯示「新增 Webhook」按鈕

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

#在網站上嵌入簽署表單

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

#後續步驟

這篇文章有幫助嗎?