署名された PDF ドキュメントから署名を削除することは、さらなる処理やアーカイブのためにクリーンなコピーが必要な場合に一般的な要件です。 GroupDocs.Signature Cloud SDK for Node.js は、PDF 署名をプログラムで操作できる強力なライブラリを提供します。このチュートリアルでは、Node.js を使用して PDF からすべての署名を削除する方法を学び、完全なコード例を確認し、REST API 用の同等の cURL コマンドも紹介します。

Node.JSで署名されたPDFドキュメントから署名を削除する5つの手順

以下の手順は、GroupDocs.Signature Cloud SDK for Node.js を使用して 署名付きPDFドキュメントから署名を削除する 方法を示します。

  1. 認証情報で構成を初期化: クライアント ID とシークレットを保持する Configuration オブジェクトを作成します。
const config = new Configuration({
    clientId: process.env.GROUPDOCS_CLIENT_ID,
    clientSecret: process.env.GROUPDOCS_CLIENT_SECRET
});
  1. API クライアントと Signature API インスタンスの作成: 設定を使用して ApiClient を作成し、次に SignatureApi を作成します。
const apiClient = new ApiClient(config);
const signatureApi = new SignatureApi(apiClient);
  1. ソースPDFファイル情報の定義: GroupDocs ストレージにある PDF の filePath を設定します。
const fileInfo = new FileInfo();
fileInfo.filePath = "input.pdf";
  1. 出力パスを指定した削除リクエストの準備: DeleteSignaturesRequest を作成し、fileInfo を割り当て、結果を保存する場所を指定します。
const deleteRequest = new DeleteSignaturesRequest();
deleteRequest.fileInfo = fileInfo;
deleteRequest.outputPath = "output.pdf";
  1. リクエストを実行し、結果を処理する: deleteSignatures を呼び出し、レスポンスを処理します。
try {
    const result = await signatureApi.deleteSignatures(deleteRequest);
    console.log("All signatures removed successfully.");
    console.log("Result file stored at:", result.path);
} catch (err) {
    console.error("Failed to remove signatures:", err);
}

各クラスの詳細については、API Reference を参照してください。

PDFからすべての署名を削除する - 完全なコード例

次の例は、署名された PDF ドキュメントから署名を削除する完全なワークフローを示しています。

const { Configuration, ApiClient, SignatureApi, DeleteSignaturesRequest, FileInfo } = require("@groupdocs/signature-cloud");

async function removeSignaturesFromPdf() {
    // Initialize configuration with your GroupDocs credentials
    const config = new Configuration({
        clientId: process.env.GROUPDOCS_CLIENT_ID,
        clientSecret: process.env.GROUPDOCS_CLIENT_SECRET
    });

// Create API client and Signature API instance
    const apiClient = new ApiClient(config);
    const signatureApi = new SignatureApi(apiClient);

// Define source PDF file (must be already uploaded to GroupDocs storage)
    const fileInfo = new FileInfo();
    fileInfo.filePath = "input.pdf"; // path in GroupDocs storage

// Prepare request to delete all signatures and store result as a new file
    const deleteRequest = new DeleteSignaturesRequest();
    deleteRequest.fileInfo = fileInfo;
    deleteRequest.outputPath = "output.pdf"; // resulting file path in storage

try {
        const result = await signatureApi.deleteSignatures(deleteRequest);
        console.log("All signatures removed successfully.");
        console.log("Result file stored at:", result.path);
    } catch (err) {
        console.error("Failed to remove signatures:", err);
    }
}

removeSignaturesFromPdf();

注: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパスや設定値を実際の環境に合わせて更新し、必要な依存関係がすべて正しくインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメント または サポートチーム にお問い合わせください。

cURL を使用した REST API による PDF 署名の削除

以下は、GroupDocs REST API を介して同じ操作を実行する cURL コマンドです。

  1. 認証してアクセストークンを取得する
curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. ソース PDF を GroupDocs ストレージにアップロードする
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary @input.pdf
  1. 削除署名操作を実行する
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/delete" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.pdf" },
           "outputPath": "output.pdf"
         }'
  1. 結果の PDF をダウンロード
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

完全な API 契約については、API Reference を参照してください。

環境の準備

npm を使用してライブラリをインストールし、Node.js のバージョンが最低要件を満たしていることを確認してください。

npm install groupdocs-signature-cloud

最新のパッケージはダウンロードページからもダウンロードできます。 有効なGroupDocsアカウントを持ち、クライアント認証情報を生成していることを確認してください。

GroupDocs.Signature Cloud SDK for Node.js が PDF 署名除去に理想的な理由

  • すべての署名タイプを削除 - テキスト、画像、バーコード、QRコード、デジタル署名をサポートします。
  • クラウドストレージ統合 - GroupDocs cloudに保存されたファイルと直接連携し、ローカルファイルの処理が不要です。
  • 高性能 - 大規模なPDFドキュメントとバッチ処理に最適化されています。
  • 包括的なAPI - 完全なRESTエンドポイントがNode.jsライブラリに反映されており、コードまたはcURLを選択する柔軟性があります。
  • 安全な処理 - すべての操作はHTTPS上で行われ、アカウントの権限を尊重します。

さらに詳しい情報については、公式ドキュメントをご参照ください。

署名削除オプションの微調整

基本的なリクエストはすべての署名を削除しますが、次のようなオプションを調整できます：

  • outputPath - 署名されていない PDF の別のフォルダーまたはファイル名を選択します。
  • fileInfo.password - ソース PDF がパスワードで保護されている場合、ここにパスワードを設定します。

出力パスの設定例（上記のコードスニペットですでに示されています）:

deleteRequest.outputPath = "output.pdf";

追加パラメータは API リファレンスに記載されています。

PDFから署名を削除するベストプラクティス

  • ファイルの存在を検証 して、リクエストを送信する前に不要な API 呼び出しを回避します。
  • 環境変数を使用 して、クライアント認証情報をソース管理から除外します。
  • 署名されていない結果を別フォルダーに保存 して、元の署名済みドキュメントを保持します。
  • エラーを適切に処理 して、例外をキャッチしエラー詳細をログに記録します。
  • 異なる署名タイプでテスト して、削除操作がすべてのシナリオで機能することを確認します。

結論

署名された PDF ドキュメントから署名を削除することは、GroupDocs.Signature Cloud SDK for Node.js を使用すれば簡単になります。ライブラリは認証、ストレージへのアクセス、削除操作を数行のコードで処理し、REST API でも cURL を使用して同様の機能が提供されます。本番環境で使用する際は適切なライセンスを取得することを忘れないでください。価格情報は製品ページで確認でき、一時ライセンスページ から一時ライセンスを取得できます。これらのツールを使用すれば、任意の Node.js ワークフローで PDF 署名の削除を自動化できます。

よくある質問

  • GroupDocs.Signature Cloud SDK for Node.js を使用して、署名された PDF ドキュメントから署名を削除する仕組みはどうなっていますか？
    ライブラリはクライアント ID とシークレットで認証し、DeleteSignatures エンドポイントを呼び出して指定された PDF からすべての署名を除去します。詳細は GroupDocs.Signature Cloud SDK for Node.js のドキュメントをご覧ください。

  • GroupDocsクラウドストレージに保存されているPDFから署名を削除できますか？
    はい。FileInfo オブジェクトにストレージパスを指定すれば、SDK が直接ファイルにアクセスします。ストレージの取り扱いについては、公式ドキュメント を参照してください。

  • 元の署名済みPDFのコピーを保持する必要がある場合はどうすればよいですか？
    DeleteSignaturesRequest の outputPath を別の場所に指定すると、元のファイルはそのままで、新しいファイルに署名が含まれません。

  • この機能を本番環境で使用するために特別なライセンスが必要ですか？
    本番環境で使用するには有効なライセンスが必要です。一時ライセンスページから一時ライセンスを取得できます。

Read More