DocuSign API：根據信封狀態向文件添加水印

使用 DocuSign API 實現動態文件水印導航

在數字文件管理不斷演變的領域，企業越來越依賴電子簽名平台來簡化工作流程，同時確保安全性和合規性。DocuSign 作為該領域的領導者，提供強大的 API 功能，允許開發者自訂流程，例如根據條件向文件添加水印。此功能對於處理敏感合約的企業特別有價值，其中文件狀態的可見性——如「已發送」、「已簽名」或「已作廢」——可以防止未經授權的存取或修改。從商業角度來看，實現基於狀態的水印可以增強審計追蹤並降低欺詐風險，從而為組織在爭議解決中節省大量時間和成本。

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

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

👉 開始免費試用

基於信封狀態在 DocuSign API 中實現水印

DocuSign 的 API 使開發者能夠將高級功能整合到應用程式中，包括回應信封生命週期的動態水印。在 DocuSign 中，信封代表一個完整的簽名流程，包括路由給收件人的一個或多個文件。水印——如「草稿」或「機密」的半透明疊加層——可以以程式方式應用，以指示狀態，確保文件反映其當前狀態而無需手動干預。這在金融或法律服務等行業特別有用，在這些行業中，即時狀態可見性對於合規性至關重要。

從商業角度來看，這種自訂可以降低營運開銷。例如，銷售團隊可以自動化水印，在發送提案時標記為「審查中」，在簽名後過渡為「已批准」。根據 DocuSign 的開發者文件，這利用了 REST API（版本 2.1），該 API 支持信封事件和文件修改。API 存取的定價從 Intermediate 計劃開始（每年 3,600 美元，約 100 個信封/月），適合中型整合，但可以透過自訂計劃擴展到企業級。

理解信封狀態和觸發器

信封狀態是 DocuSign 的核心概念，透過 API 回應中的 status 欄位進行追蹤。常見狀態包括：

• Created：信封已起草但未發送。
• Sent：信封已分發給收件人。
• Delivered：收件人已查看文件。
• Signed：所有簽名已完成。
• Completed：信封已最終確定。
• Voided：信封已取消。

要基於這些狀態添加水印，開發者可以使用 Webhook（透過 Connect 功能，在 Advanced API 計劃中可用，每年 5,760 美元）監控狀態變化。Webhook 會通知您的應用程式事件，從而觸發 API 呼叫來更新文件。這種事件驅動方法確保水印即時應用，與業務對動態內容控制的需求保持一致。

對於合規性，請注意水印不得遮擋簽名或關鍵文字，需遵守美國 ESIGN Act 或歐盟 eIDAS 等標準。在規則更嚴格的地區，如亞太地區的碎片化法規中，還需考慮資料駐留等額外因素，但 DocuSign 的全球基礎設施可以處理大多數情況。

逐步 API 實施

實現此功能需要 DocuSign 開發者帳戶（免費沙箱可用）和對 JSON 負載的熟悉。以下是基於官方 API 文件的中性、實用指南：

1. 認證並擷取信封狀態： 使用 OAuth 2.0 進行認證（所有 API 計劃均支持）。呼叫 Envelopes::getStatus 端點來獲取當前狀態：

   GET /restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}
   

   回應範例：

   {
     "status": "sent",
     "documents": [...]
   }
   

   將此整合到您的應用的輪詢或 Webhook 監聽器中。

2. 準備水印配置： 透過 DocumentVisibility 或自訂文字疊加層定義水印。對於基於狀態的邏輯，使用條件渲染。在信封建立負載（Envelopes::create）中包含 brand 物件用於水印，但對於動態更新，使用 Envelopes::updateDocuments。

3. 條件應用水印： 根據狀態，呼叫 Envelopes::createDocument 或 Documents::update 來疊加文字。例如，要添加「已發送」水印：

   • 擷取文件 PDF 位元組。
   • 使用 iText（Java）或 PDFtk 等程式庫在座標處嵌入水印文字（例如，對角線跨頁面）。
   • 透過 POST /restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/documents/{documentId} 上傳修改後的 PDF。

   範例程式碼片段（Node.js 與 DocuSign SDK）：

   const dsApi = new docusign.ApiClient();
   dsApi.setBasePath('https://demo.docusign.net/restapi');
   const envelopesApi = new docusign.EnvelopesApi(dsApi);
   
   // 檢查狀態
   const envelopeStatus = await envelopesApi.getEnvelope(accountId, envelopeId);
   if (envelopeStatus.status === 'sent') {
     // 生成水印 PDF
     const watermarkedPdf = addWatermark(originalPdf, 'SENT - Do Not Distribute');
     // 上傳更新文件
     await envelopesApi.updateDocument(accountId, envelopeId, { documentBase64: watermarkedPdf.toString('base64') });
   }
   

   這確保水印僅出現在相關頁面上，同時保留簽名字段。

4. 處理批次和自動化限制： DocuSign 對自動化發送有限制（例如，Business Pro 計劃中每用戶每年約 100 次，480 美元/用戶/年），包括 API 觸發的更新。對於高容量使用，選擇具有自訂配額的企業計劃。在沙箱中測試以避免超額。

5. 錯誤處理和最佳實務： 監控 API 速率限制（例如，Starter 計劃中每小時 1,000 次呼叫）。使用 try-catch 處理狀態不匹配。對於安全性，使用時間戳加密水印以防止篡改。根據行業基準，企業報告此類自動化可帶來高達 30% 的效率提升。

此實施通常需要開發者 1-2 週時間，透過減少手動審查實現 ROI。對於高級需求，DocuSign 的 IAM（身份和存取管理）整合 SSO 和審計日誌，而 CLM（合約生命週期管理）擴展到完整合約追蹤——適合超出基本電子簽名的企業。

競爭格局：DocuSign 與關鍵替代方案

DocuSign 以其全面的 API 生態系統佔據主導地位，但競爭對手在定價、區域焦點和易用性方面提供不同的優勢。從商業觀察來看，選擇取決於規模、地理位置和整合深度。

DocuSign 提供端到端的電子簽名解決方案，包括所討論的 API 驅動功能。其優勢在於全球可擴展性和整合（例如，與 Salesforce），儘管按座位定價對於團隊可能會迅速上升。

Adobe Sign 作為 Adobe Document Cloud 的一部分，在 PDF 中心工作流程中表現出色，與 Acrobat 無縫整合。它透過其 REST API 支持類似的 API 水印，專注於創意行業。定價從個人 10 美元/用戶/月開始，擴展到企業自訂。然而，與 DocuSign 相比，它可能需要更多設定來實現基於狀態的自動化。

eSignGlobal 將自身定位為成本效益高的替代方案，強調無限用戶和亞太優化。它符合全球超過 100 個主流國家的法規，在亞太地區具有特別優勢，該地區電子簽名法律碎片化、高標準且嚴格監管。與美國/歐盟的基於框架的 ESIGN/eIDAS 標準（依賴電子郵件驗證或自我聲明）不同，亞太地區要求「生態系統整合」方法——與政府數字身份（G2B）的深度硬體/API 整合。這包括與香港 iAM Smart 或新加坡 Singpass 等系統的無縫對接，提高了遠高於西方模式的技術壁壘。eSignGlobal 的 Essential 計劃僅需 16.6 美元/月（年度），允許最多 100 個文件簽名、無限用戶座位和存取碼驗證——所有這些基於合規、高價值的基礎，與競爭對手相比具有競爭性定價。

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

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

👉 開始免費試用

HelloSign（現為 Dropbox Sign）提供使用者友好的介面和 API 支持水印，適合 SMB。其免費層和 15 美元/月專業計劃吸引初創企業，儘管高級自動化落後於 DocuSign。

此表格突出了權衡：DocuSign 在 API 深度方面領先，而 eSignGlobal 等替代方案在成長團隊的負擔能力方面脫穎而出。

結論：選擇正確的電子簽名平台

評估 DocuSign API 用於基於狀態水印等功能的企業，應權衡整合成本與需求。對於全球營運，DocuSign 仍是可靠選擇。作為替代方案，考慮 eSignGlobal 等區域合規選項，以優化亞太部署。