DocuSign API：如何在特定資料夾中取得所有範本的清單？

DocuSign 模板和 API 介紹

在數字文件管理不斷演變的格局中，DocuSign 作為領先的電子簽名平台脫穎而出，它為全球企業簡化了工作流程。模板在 DocuSign 中發揮著關鍵作用，允許使用者標準化文件以供重複使用，從而節省時間並確保合約審批或入職等流程的一致性。DocuSign API 使開發者能夠以程式方式自動化這些任務，便於將電子簽名功能整合到自訂應用程式中。本文探討如何利用 DocuSign API 從特定資料夾中擷取所有模板清單，這是企業環境中高效模板管理的一個常見需求。

正在比較帶有 DocuSign 或 Adobe Sign 的電子簽名平台？

eSignGlobal 提供更靈活且性價比更高的電子簽名解決方案，具備全球合規性、透明定價和更快的入職流程。

👉 開始免費試用

理解 DocuSign 模板

DocuSign 模板是預配置的文件，其中包含預定義欄位、簽署者角色和工作流程。它們在 DocuSign 帳戶中組織成資料夾，使用戶能夠按部門、專案或類型對它們進行分類——例如，將 HR 模板放在一個資料夾中，將銷售協議放在另一個資料夾中。這種組織對於處理大量文件的團隊至關重要，因為它可以防止雜亂並便於快速存取。

從業務角度來看，模板可以減少錯誤並加速簽名流程。例如，銷售團隊可以重複使用提案模板，而無需每次重新建立欄位，從而確保品牌一致性和合規性。然而，對於擁有數百個模板的大型帳戶，手動瀏覽資料夾可能效率低下。這就是 DocuSign API 的用武之地，它提供了一種程式方式來查詢和列出模板。

DocuSign API 入門

要使用 DocuSign API，開發者需要一個活躍的 DocuSign 帳戶和 API 憑證。DocuSign 提供了一個免費的沙盒環境用於測試，該環境鏡像生產功能。認證通常涉及 OAuth 2.0，您可以從 DocuSign 開發者中心產生整合金鑰（客戶端 ID）和金鑰。

模板的關鍵端點位於 eSignature API 下，具體為 /accounts/{accountId}/templates 資源。您需要帳戶 ID，可以透過 /accounts 端點獲取。DocuSign 中的資料夾由唯一的資料夾 ID 標識，這些 ID 可以使用 /folders 端點擷取。這種設定確保了對模板資料的安全、可擴展存取。

DocuSign 的 API 文件全面，支持 Java、.NET、PHP 和 Python 等語言的 SDK，簡化了整合。對於企業而言，這意味著可以將電子簽名嵌入 CRM 系統（如 Salesforce）或自訂應用程式中，從而提升營運效率，而無需切換工具。

如何使用 DocuSign API 從特定資料夾擷取模板

使用 DocuSign REST API 從特定資料夾擷取模板清單是一個簡單過程。此功能對於需要動態填充模板選項或稽核資料夾內容的應用程式特別有用。核心端點是 GET /accounts/{accountId}/folders/{folderId}/templates，它返回指定資料夾中模板的分頁清單。

先決條件

在深入程式碼之前，請確保：

• 您擁有 OAuth 2.0 存取令牌。
• 已知帳戶 ID 和資料夾 ID。要獲取資料夾 ID，首先呼叫 GET /accounts/{accountId}/folders 以列出所有資料夾並識別您需要的資料夾（例如，按名稱或共享狀態）。
• 權限：API 使用者必須具有模板讀取存取權限。

逐步實施

1. 認證並獲取令牌： 使用 OAuth 流程獲取存取令牌。例如，在 Python 中使用 DocuSign eSignature SDK：

   import docusign_esign as ds_esign
   
   # 配置 API 客戶端
   api_client = ds_esign.ApiClient()
   api_client.host = 'https://demo.docusign.net/restapi'  # 測試時使用 demo
   api_client.set_default_header('Authorization', 'Bearer ' + access_token)
   

2. 擷取資料夾 ID： 如果資料夾 ID 未知，請列出資料夾：

   envelopes_api = ds_esign.EnvelopesApi(api_client)
   folders = envelopes_api.list_folders(account_id)
   # 迭代查找按名稱的資料夾，例如 folder_id = next(f['folderId'] for f in folders if f['folderName'] == 'My Templates Folder')
   

3. 列出資料夾中的模板： 使用 Templates API 獲取模板：

   templates_api = ds_esign.TemplatesApi(api_client)
   template_list = templates_api.list_templates(account_id, folder=folder_id, count=100)  # 調整 count 以進行分頁
   for template in template_list.envelopes:
       print(f"Template Name: {template.name}, ID: {template.template_id}")
   

   這將返回模板名稱、ID、共享狀態和最後修改日期等詳細資訊。回應為 JSON 格式，其中包含模板摘要的 envelopes 陣列。

4. 處理分頁和錯誤： 如果資料夾中的模板超過指定數量（預設 20，最大 100），請使用 start_position 查詢參數獲取後續頁面。常見錯誤包括 401（未授權）或 404（資料夾未找到）——始終包含錯誤處理：

   try:
       template_list = templates_api.list_templates(account_id, folder=folder_id)
   except ds_esign.ApiException as e:
       print(f"Error: {e.body}")
   

5. 進階篩選： 新增查詢參數，如 search_text 以按名稱篩選，或 include 以包含共享模板。對於企業使用者，這與網路鉤子整合良好，用於模板變更時的即時更新。

此 API 呼叫通常只需毫秒時間，非常適合 UI 驅動的應用程式，其中使用者從資料夾模板下拉清單中選擇。企業報告，透過自動化模板發現，文件準備時間可節省高達 50%。

範例用例

想像一家律師事務所將 DocuSign 與其案件管理系統整合。API 從「Contracts」資料夾中拉取模板，根據案件類型自動填充，從而確保合規性和速度。

透過 API 管理模板的最佳實務

在實施此 API 功能時，請優先考慮安全性，使用 JWT 或授權碼授權來獲取令牌，並定期輪換它們。使用快取限制 API 呼叫以避免速率限制（例如，生產環境中每小時 1,000 次呼叫）。為實現可擴展性，請使用 DocuSign 的 Connect 網路鉤子來通知您的應用程式新模板，而無需輪詢。

透過 API 儀表板監控使用情況，以追蹤信封配額，因為模板在 Business Pro 等計劃中會計入整體限制。在沙盒中測試可以防止生產中斷。

與競爭對手比較 DocuSign

DocuSign 是一個強大的電子簽名平台，提供無縫 API 整合和全球合規性。其模板管理在結構化環境中表現出色，但定價會隨著使用者及功能而擴展。

Adobe Sign 現為 Adobe Document Cloud 的一部分，提供與 Adobe 生態系統的強大整合，如 PDF 編輯。它對創意團隊友好，但進階 API 使用可能需要額外許可。

eSignGlobal 作為競爭性替代方案脫穎而出，尤其在亞太（APAC）地區。它支持全球 100 個主流國家的合規性，特別強調 APAC 碎片化的監管格局。與美國（ESIGN）或歐洲（eIDAS）的基於框架的標準不同，後者依賴電子郵件驗證或自我聲明，APAC 法規要求生態系統整合的解決方案——與政府數字身份（G2B）的深度硬體和 API 級整合。這包括高標準和嚴格監督，將技術壁壘提高到遠高於西方模式的水平。eSignGlobal 在此領域表現出色，提供與香港 iAM Smart 和新加坡 Singpass 的無縫整合，同時具備無限使用者及性價比高的定價。其 Essential 計劃僅需每月 16.6 美元，允許發送多達 100 個電子簽名文件、無限使用者席位，並透過存取碼驗證，在合規基礎上提供高價值。這使 eSignGlobal 能夠與 DocuSign 和 Adobe Sign 在全球競爭，通常以更低的成本。

正在尋找比 DocuSign 更智能的替代方案？

eSignGlobal 提供更靈活且性價比更高的電子簽名解決方案，具備全球合規性、透明定價和更快的入職流程。

👉 開始免費試用

HelloSign（現為 Dropbox Sign）專注於簡單性，提供直觀的模板和適合小團隊的 API 存取。它對基本需求性價比高，但缺乏一些企業級功能。

此表格突出了中性權衡：DocuSign 用於規模，Adobe 用於整合，eSignGlobal 用於區域價值，HelloSign 用於易用性。

結論

導航 DocuSign 的 API 以進行模板管理可以顯著提升生產力，尤其是在特定資料夾查詢方面。對於尋求替代方案的企業，eSignGlobal 在 APAC 及更廣泛地區提供堅實、區域合規的選擇。