DocuSign API: 「結合」PDFと個別のPDFをダウンロードする方法

DocuSignのPDFダウンロードAPIについて理解する

電子署名プラットフォームの競争環境において、DocuSignは大量のドキュメントワークフローを処理する企業リーダーとして際立っています。小規模なチームから大企業まで、そのAPIはカスタムアプリケーションにシームレスに統合でき、契約書の送信から署名済みドキュメントの取得まで、あらゆる操作を自動化します。開発者が直面する一般的な課題は、署名後のPDF出力を管理することです。具体的には、「Combined」PDF（すべてのドキュメントと署名をマージした単一のファイル）と、各エンベロープコンポーネントの個別のPDFをダウンロードすることです。この記事では、DocuSignの開発者ドキュメントと実際のビジネスユースケースを参照しながら、このAPI機能を詳細に検討し、その実装に対する中立的な視点を維持します。

ドキュメント管理におけるDocuSign APIの役割

DocuSignのeSignature APIは、Intelligent Agreement Management (IAM) やContract Lifecycle Management (CLM) などのツールを含む、より広範なエコシステムの一部です。IAMは、シングルサインオン（SSO）、高度な監査証跡、認証などの機能を通じてセキュリティを強化し、金融や医療などの規制対象業界に最適です。一方、CLMは、作成から更新までの契約プロセス全体を簡素化し、CRMシステムと統合してエンドツーエンドの可視性を実現します。これらの製品は、DocuSignのコンプライアンスと効率への注力を強調していますが、開発者にとってAPIはカスタム統合のバックボーンです。

PDFダウンロードに関しては、APIは署名済みドキュメントへのプログラムによるアクセスを許可するエンドポイントを提供します。これは、HRのオンボーディングや販売契約の履行など、ドキュメントの迅速な取得が手動エラーを減らし、プロセスを加速できる自動化されたワークフローを持つ企業にとって不可欠です。重要な違いは、「Combined」PDF（元のドキュメント、署名者の添付ファイル、および完了証明書を1つのファイルにマージしたもの）と、エンベロープを署名済みフォームや監査ログなどの個々のコンポーネントに分解する個別のPDFです。

DocuSign APIを使用して「Combined」PDFをダウンロードする方法

DocuSign eSignature REST APIを介してCombined PDFをダウンロードするのは非常に簡単で、特にEnvelopes APIを使用する場合です。この方法は、法的審査や顧客への納品など、統一されたファイルでアーカイブや共有を簡素化する必要があるシナリオで特に好まれます。以下は、DocuSignの公式API v2.1ドキュメントに基づくステップバイステップガイドです。

1. 認証してアクセス トークンを取得する：まず、OAuth 2.0 JWTトークンを生成するか、Authorization Code Grantを使用します。これにより、安全なAPI呼び出しが保証されます。本番環境では、トークンの更新を自動的に処理するために、アプリケーションのバックエンドに統合します。

2. エンベロープの詳細を取得する：GET /envelopes/{envelopeId}エンドポイントを使用して、エンベロープのステータスを取得します。続行する前に、「completed」ステータスであることを確認してください。応答には、ドキュメントIDと受信者の詳細が含まれます。

3. Combined PDFをリクエストする：GET /envelopes/{envelopeId}/documents/combinedエンドポイントを呼び出します。これにより、以下を含む単一のPDFが返されます。

   • 署名とフィールドが適用された元のドキュメント。
   • 署名者の添付ファイル（存在する場合）。
   • 署名監査証跡をまとめた完了証明書。

   cURLリクエストの例（プレースホルダーを置き換えてください）：

   curl -X GET "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/documents/combined" \
   -H "Authorization: Bearer {accessToken}" \
   -o combined.pdf
   

   応答はバイナリPDFストリームであり、直接保存できます。コード内（たとえば、DocuSign SDKのNode.jsを使用）では、EnvelopesApi.getDocumentメソッドを使用し、combinedパラメーターをtrueに設定します。

4. 大きなファイルとエラーを処理する：複数のドキュメントを含むエンベロープの場合、Combined PDFは25MBを超える可能性があります。APIクォータ（たとえば、Starterプランでは月あたり約40個のエンベロープが許可されます）を監視してください。404（見つからない）または429（レート制限）応答のエラー処理を実装します。

ビジネスの観点から見ると、この方法はコンプライアンスレポートを簡素化します。DocuSign AdvancedまたはEnterpriseプランを使用する企業は、Bulk Send統合などの機能強化の恩恵を受け、Combined PDFを大規模な配布に一括で使用できます。ただし、自動送信には上限があることに注意してください（たとえば、ユーザーあたり月あたり約10個）。したがって、大量のユーザーはカスタムEnterprise価格設定が必要になる場合があります。

個別のPDFをダウンロードする：いつ、どのように

対照的に、個別のPDFは粒度を提供し、コンポーネントを分離する必要があるワークフローで非常に役立ちます。たとえば、署名済み契約書のみをデータベースストレージ用に抽出したり、監査ログを規制監査用に個別に送信したりする場合などです。この方法は、同じEnvelopes APIを使用しますが、個々のドキュメントを対象としています。

1. エンベロープ内のドキュメントを一覧表示する：GET /envelopes/{envelopeId}/documentsをクエリして、ドキュメントIDのリストを取得します。各IDは、メインドキュメント（ID 1）、添付ファイル、または完了証明書（通常、概要にはID -1）などの特定のファイルに対応します。

2. 個々のPDFをダウンロードする：各ドキュメントについて、GET /envelopes/{envelopeId}/documents/{documentId}を使用します。クエリで形式をPDFとして指定します（たとえば、?format=pdf）。

   例：

   curl -X GET "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/documents/{documentId}" \
   -H "Authorization: Bearer {accessToken}" \
   -o document_{documentId}.pdf
   

   Pythonのdocusign-esignなどのSDKでは、ドキュメントを反復処理します。

   api_instance = EnvelopesApi()
   results = api_instance.get_document(account_id, envelope_id, document_id, token)
   with open(f'doc_{document_id}.pdf', 'wb') as f:
       f.write(results)
   

3. ユースケースと制限：個別のダウンロードは、バージョン管理のためにCLMと統合するなど、モジュール式システムで優れています。ただし、より多くのAPI呼び出しが必要になり、遅延とコストが増加します（APIプランはStarterの年間600ドルから始まります）。条件付きロジックまたはWeb Forms（Business Pro機能）を含むエンベロープの場合、不完全なセットを避けるために、関連するすべてのIDを取得してください。

ビジネスオブザーバーは、Combined PDFはストレージオーバーヘッドを削減しますが（1つのファイル対複数のファイル）、個別のPDFは特定のセクションを解析するための分析ツールの柔軟性を高めることに注意しています。アジア太平洋地域（APAC）では、データ所在地ルールが異なり、個別の処理はローカルストレージ要件の遵守に役立ちます。

主な違い：Combined vs. 個別のPDF

この比較は、企業が効率とニーズをどのようにトレードオフするかを強調しています。Combinedは速度を重視し、個別のPDFは正確性を重視します。

競争環境：電子署名プラットフォームの比較

DocuSignのAPIの利点をコンテキスト化するために、Adobe Sign、eSignGlobal、HelloSign（現在はDropbox Sign）などの代替手段を検討してください。それぞれがPDF処理へのAPIアクセスを提供していますが、価格、コンプライアンス、および地域的な焦点が異なります。以下は、2025年の公開データに基づく中立的な比較です。

この表は、DocuSignのエンタープライズの利点を示していますが、競合他社のコストと地域的な違いを強調しています。

電子署名プラットフォームをDocuSignまたはAdobe Signと比較していますか？

eSignGlobalは、グローバルコンプライアンス、透明性のある価格設定、およびより迅速なオンボーディングを備えた、より柔軟で費用対効果の高い電子署名ソリューションを提供します。

👉 無料トライアルを開始

Adobe Signの焦点

Adobe Signは、Adobe Document Cloudの一部として、クリエイティブおよびドキュメント集約型の業界で優れています。そのAPIは、/agreements/{agreementId}/combinedDocumentなどのエンドポイントを使用して、DocuSignのCombinedおよび個別のPDFダウンロードと同様のものをサポートしています。価格は基本版の低価格から始まりますが、ユーザー数に応じて拡張され、PDF埋め込み署名を必要とするマーケティングチームに適しています。ただし、完全なCLMのような機能を実現するには、追加のAdobeライセンスが必要になる場合があります。

eSignGlobalの焦点

eSignGlobalは、100を超える主要国でコンプライアンスを遵守し、アジア太平洋地域（APAC）で強力な存在感を示すグローバルプレーヤーとしての地位を確立しています。APACの電子署名環境は断片化されており、高い基準と厳格な規制があります。米国/EUのフレームワークのようなESIGN/eIDASとは異なり、APACは「エコシステム統合」コンプライアンスを重視しています。これには、政府のデジタルID（G2B）との深いハードウェア/APIドッキングが必要であり、これは西洋で一般的な電子メール検証や自己申告をはるかに超える技術的なハードルです。eSignGlobalは、DocuSignおよびAdobe Signに対して、米国およびヨーロッパを含むグローバルな包括的な競争プログラムを開始し、競争力のある価格設定を提供しています。たとえば、そのEssentialバージョンは月額わずか16.6ドルで、最大100個の電子署名ドキュメント、無制限のユーザーシート、およびアクセスコード検証を許可しながら、コンプライアンスを維持します。香港のiAM SmartおよびシンガポールのSingpassとシームレスに統合し、地域の効率を向上させます。

DocuSignのよりスマートな代替手段をお探しですか？

eSignGlobalは、グローバルコンプライアンス、透明性のある価格設定、およびより迅速なオンボーディングを備えた、より柔軟で費用対効果の高い電子署名ソリューションを提供します。

👉 無料トライアルを開始

ビジネスへの影響と最終的な考察

開発者およびITリーダーにとって、DocuSignのPDFダウンロードAPIを習得するとワークフローを最適化できますが、クォータとコストに注意する必要があります。特に、高度な機能のためのIntermediate（年間3600ドル）のようなAPIプランではそうです。DocuSignはエンタープライズドメインを支配していますが、代替手段はコストに敏感な、または地域に焦点を当てた運用に実行可能なパスを提供します。中立的な推奨として、eSignGlobalは、特にAPACの地域コンプライアンスのニーズに対して、DocuSignの信頼できる代替手段として際立っています。