حذف امضاها از PDF امضاشده در Node.JS

حذف امضاها از سند PDF امضا شده یک نیاز رایج است زمانی که به یک نسخه تمیز برای پردازش یا بایگانی بیشتر نیاز دارید. GroupDocs.Signature Cloud SDK for Node.js کتابخانه‌ای قدرتمند ارائه می‌دهد که به شما امکان می‌دهد امضاهای PDF را به‌صورت برنامه‌نویسی مدیریت کنید. در این آموزش، خواهید آموخت که چگونه تمام امضاها را از یک PDF با استفاده از Node.js حذف کنید، یک مثال کامل کد را مشاهده کنید و دستورات معادل cURL برای REST API را بررسی کنید.

حذف امضاها از سند PDF امضا شده در Node.JS در 5 مرحله

مراحل زیر نشان می‌دهند که چگونه با استفاده از GroupDocs.Signature Cloud SDK for Node.js، حذف امضاها از سند PDF امضا شده را انجام دهید.

1. پیکربندی را با اعتبارها مقداردهی اولیه کنید: یک شیء Configuration ایجاد کنید که شناسه مشتری و رمز عبور شما را نگه دارد.

const config = new Configuration({
    clientId: process.env.GROUPDOCS_CLIENT_ID,
    clientSecret: process.env.GROUPDOCS_CLIENT_SECRET
});

2. ایجاد کلاینت API و نمونه Signature API: از پیکربندی برای ساخت یک ApiClient و سپس یک SignatureApi استفاده کنید.

const apiClient = new ApiClient(config);
const signatureApi = new SignatureApi(apiClient);

3. تعریف اطلاعات فایل PDF منبع: مسیر filePath فایل PDF که در ذخیره‌سازی GroupDocs قرار دارد را تنظیم کنید.

const fileInfo = new FileInfo();
fileInfo.filePath = "input.pdf";

4. آماده‌سازی درخواست حذف با مسیر خروجی: یک DeleteSignaturesRequest ایجاد کنید، fileInfo را اختصاص دهید و مشخص کنید که نتیجه در کجا ذخیره شود.

const deleteRequest = new DeleteSignaturesRequest();
deleteRequest.fileInfo = fileInfo;
deleteRequest.outputPath = "output.pdf";

5. اجرای درخواست و پردازش نتیجه: فراخوانی 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 مراجعه کنید.

حذف تمام امضاها از 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();

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، مطمئن شوید که مسیرهای فایل و مقادیر پیکربندی را به‌گونه‌ای به‌روز کنید که با محیط واقعی شما مطابقت داشته باشد، اطمینان حاصل کنید که تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند، و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک به تیم پشتیبانی مراجعه کنید.

حذف امضاهای PDF از طریق REST API با استفاده از cURL

در زیر دستورات cURL آورده شده‌اند که همان عملیات را از طریق GroupDocs REST API انجام می‌دهند.

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"

2. بارگذاری PDF منبع به GroupDocs storage

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

3. عملیات حذف امضاها را اجرا کنید

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"
         }'

4. دانلود 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 برای 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 فراهم می‌کند. به یاد داشته باشید برای استفاده در محیط تولید یک لایسنس مناسب تهیه کنید؛ جزئیات قیمت‌گذاری در صفحه محصول موجود است و می‌توانید یک لایسنس موقت از صفحه لایسنس موقت دریافت کنید. با این ابزارها می‌توانید حذف امضای PDF را در هر جریان کاری Node.js خودکار کنید.

سوالات متداول

• حذف امضاها از سند PDF امضا شده با GroupDocs.Signature Cloud SDK for Node.js چگونه کار می‌کند؟
  کتابخانه با استفاده از شناسه مشتری (client ID) و رمز عبور شما احراز هویت می‌کند، سپس endpoint DeleteSignatures را فراخوانی می‌کند تا تمام امضاها را از PDF مشخص شده حذف کند. برای جزئیات به مستندات GroupDocs.Signature Cloud SDK for Node.js مراجعه کنید.

• آیا می‌توانم امضاها را از یک PDF ذخیره‌شده در فضای ذخیره‌سازی ابری GroupDocs حذف کنم؟
  بله. مسیر ذخیره‌سازی را در شیء FileInfo ارائه دهید و SDK به‌صورت مستقیم به فایل دسترسی خواهد یافت. برای مدیریت ذخیره‌سازی به مستندات رسمی مراجعه کنید.

• اگر نیاز داشته باشم یک نسخه از PDF امضاشدهٔ اصلی را نگه دارم چه؟
  یک outputPath متفاوت در DeleteSignaturesRequest مشخص کنید تا فایل اصلی دست نخورده بماند و فایل جدید بدون امضا باشد.

• آیا برای استفاده از این عملکرد در تولید به مجوز خاصی نیاز دارم؟
  یک مجوز معتبر برای استفاده در تولید لازم است. می‌توانید یک مجوز موقت را از صفحه صفحه مجوز موقت دریافت کنید.

بیشتر بخوانید

• نحوه امضای دیجیتال یک سند Word به صورت آنلاین
• حذف امضاها از سند PDF امضا شده با استفاده از Python
• ویرایش امضاها در اسناد PDF امضا شده با استفاده از Python