إزالة التوقيعات من ملف PDF موقع في Node.JS

إزالة التوقيعات من مستند PDF موقّع هو طلب شائع عندما تحتاج إلى نسخة نظيفة للمعالجة الإضافية أو الأرشفة. يوفر GroupDocs.Signature Cloud SDK for Node.js مكتبة قوية تتيح لك التعامل مع توقيعات PDF برمجياً. في هذا البرنامج التعليمي ستتعلم كيفية حذف جميع التوقيعات من ملف PDF باستخدام Node.js، وسترى مثالاً كاملاً على الشيفرة، وتستكشف أوامر cURL المكافئة لواجهة برمجة التطبيقات REST.

إزالة التوقيعات من مستند PDF موقع في Node.JS في 5 خطوات

الخطوات التالية توضح كيفية إزالة التوقيعات من مستند PDF موقع باستخدام GroupDocs.Signature Cloud SDK for Node.js.

تهيئة التكوين باستخدام بيانات الاعتماد: إنشاء كائن Configuration يحتوي على معرف العميل (client ID) والسر (secret).

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

إنشاء عميل API ومثيل Signature API: استخدم التكوين لإنشاء ApiClient ثم SignatureApi.

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

تحديد معلومات ملف PDF المصدر: تعيين filePath لملف PDF الموجود في تخزين GroupDocs.

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

تحضير طلب الحذف مع مسار الإخراج: إنشاء DeleteSignaturesRequest، تعيين fileInfo، وتحديد المكان الذي يجب حفظ النتيجة فيه.

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

تنفيذ الطلب ومعالجة النتيجة: استدعِ 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 باستخدام cURL

فيما يلي أوامر cURL التي تقوم بنفس العملية عبر GroupDocs REST API.

المصادقة والحصول على رمز الوصول

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"

تحميل ملف 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

تنفيذ عملية حذف التوقيعات

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

تنزيل ملف 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.

إعداد البيئة

قم بتثبيت المكتبة عبر npm وتأكد من أن إصدار Node.js الخاص بك يلبي المتطلبات الدنيا.

npm install groupdocs-signature-cloud

يمكنك أيضًا تنزيل أحدث حزمة من صفحة التنزيل. تأكد من أن لديك حساب GroupDocs صالح وقد قمت بإنشاء بيانات اعتماد العميل.

ما الذي يجعل GroupDocs.Signature Cloud SDK for Node.js مثالياً لإزالة توقيع PDF

حذف جميع أنواع التوقيع - يدعم النص، الصورة، الباركود، رمز QR، والتوقيعات الرقمية.
تكامل التخزين السحابي - يعمل مباشرةً مع الملفات المخزنة في سحابة GroupDocs، مما يلغي الحاجة إلى معالجة الملفات محليًا.
أداء عالي - مُحسّن للمستندات الكبيرة بصيغة PDF ومعالجة الدُفعات.
واجهة برمجة تطبيقات شاملة - تم عكس جميع نقاط النهاية 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؟
تقوم المكتبة بالمصادقة باستخدام معرف العميل والسر الخاص بك، ثم تستدعي نقطة النهاية DeleteSignatures لإزالة جميع التوقيعات من ملف PDF المحدد. راجع وثائق GroupDocs.Signature Cloud SDK for Node.js للحصول على التفاصيل.
هل يمكنني حذف التوقيعات من ملف PDF مخزن في تخزين GroupDocs السحابي؟
نعم. قدم مسار التخزين في كائن FileInfo وسيتعامل SDK مع الملف مباشرة. راجع التوثيق الرسمي لمعالجة التخزين.
ماذا لو احتجت إلى الاحتفاظ بنسخة من ملف PDF الموقع الأصلي؟
حدد outputPath مختلفًا في DeleteSignaturesRequest بحيث يبقى الملف الأصلي دون تعديل بينما يحتوي الملف الجديد على أي توقيعات.
هل أحتاج إلى ترخيص خاص لاستخدام هذه الوظيفة في الإنتاج؟
يتطلب الاستخدام في الإنتاج ترخيصًا صالحًا. يمكنك الحصول على ترخيص مؤقت من صفحة الترخيص المؤقت.

إزالة التوقيعات من مستند PDF موقع في Node.JS في 5 خطوات#

إزالة جميع التوقيعات من PDF - مثال كامل للكود#

إزالة توقيعات PDF عبر واجهة برمجة التطبيقات REST باستخدام cURL#

إعداد البيئة#

ما الذي يجعل GroupDocs.Signature Cloud SDK for Node.js مثالياً لإزالة توقيع PDF#

ضبط خيارات حذف التوقيع بدقة#

أفضل الممارسات لإزالة التوقيعات من ملفات PDF#

الخلاصة#

الأسئلة الشائعة#

Read More#