قم بتوقيع المستندات باستخدام التوقيعات الرقمية باستخدام REST API في Node.js

يمكنك توقيع مستنداتك إلكترونيًا باستخدام التوقيعات الرقمية برمجيًا على السحابة. تُستخدم التواقيع الرقمية للتحقق من صحة المستندات وتكاملها. كما أنه يمكّنك من إرفاق رمز مع المستند الخاص بك والذي يعمل كتوقيع. ستركز هذه المقالة على كيفية توقيع المستندات بالتوقيعات الرقمية باستخدام واجهة برمجة تطبيقات REST في Node.js.

سيتم تناول الموضوعات التالية في هذه المقالة:

وثيقة التوقيع REST API و Node.js SDK

لتوقيع ملفات PDF و DOCX ، سأستخدم Node.js SDK من GroupDocs.Signature Cloud API. يمكّنك من إنشاء أنواع مختلفة من التواقيع والتحقق منها والبحث عنها مثل الصورة والرمز الشريطي ورمز الاستجابة السريعة والتوقيعات المستندة إلى النص والرقمية والتوقيعات الطوابع. يمكن تطبيق هذه التواقيع بسهولة في مستندات وجداول بيانات وعروض تقديمية وصور ذات تنسيقات ملفات مدعومة محمولة أو بسيطة. يمكنك دمج API في تطبيقات Node.js الموجودة لديك. كما أنها توفر تطبيقات .NET و Java و PHP و Android و Ruby و Python SDK باعتبارها أعضاء عائلة توقيع المستندات لواجهة برمجة التطبيقات السحابية.

يمكنك تثبيت GroupDocs.Signature Cloud على مشروع Node.js الخاص بك باستخدام الأمر التالي في وحدة التحكم:

npm install groupdocs-signature-cloud --save

يرجى الحصول على معرف العميل والسرية من لوحة التحكم قبل اتباع الخطوات المذكورة. بمجرد حصولك على المعرف والسر الخاص بك ، قم بإضافة الرمز كما هو موضح أدناه:

global.clientId = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
global.clientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
global.myStorage = "";

const config = new groupdocs_signature_cloud.Configuration(clientId, clientSecret);
config.apiBaseUrl = "https://api.groupdocs.cloud";

قم بتسجيل مستندات Word باستخدام واجهة برمجة تطبيقات REST في Node.js

يمكنك توقيع مستندات Word بالتوقيعات الرقمية على السحابة باتباع الخطوات البسيطة المذكورة أدناه:

قم بتحميل المستند

أولاً ، قم بتحميل مستند Word إلى Cloud باستخدام مثال الرمز الموضح أدناه:

var resourcesFolder = 'C:\\Files\\sample.docx';
fs.readFile(resourcesFolder, (err, fileStream) => {
  // بناء FileApi
  var fileApi = groupdocs_signature_cloud.FileApi.fromConfig(config);
  // طلب إنشاء ملف تحميل
  var request = new groupdocs_signature_cloud.UploadFileRequest("sample.docx", fileStream, myStorage);
  fileApi.uploadFile(request)
});

نتيجة لذلك ، سيكون ملف Word الذي تم تحميله متاحًا في قسم الملفات من لوحة المعلومات على السحابة. الرجاء استخدام نموذج الرمز أعلاه لتحميل الشهادة وملف صورة التوقيع إلى السحابة.

قم بتوقيع مستندات Word بالتوقيعات الرقمية باستخدام Node.js

يمكنك توقيع ملفات DOCX الخاصة بك بالتوقيعات الرقمية برمجيًا باتباع الخطوات الواردة أدناه:

  • قم بإنشاء مثيل SignApi
  • قم بإنشاء مثيل FileInfo
  • قم بتعيين مسار ملف DOCX
  • قم بإنشاء مثيل لـ SignDigitalOptions
  • اضبط SignatureType على Digital
  • قم بتعيين ImageFilePath و CertificateFilePath
  • أدخل كلمة المرور
  • اضبط موضع التوقيع
  • قم بإنشاء مثيل SignSettings
  • قم بتعيين SignDigitalOptions و SaveOptions إلى SignSettings
  • قم بإنشاء CreateSignaturesRequest
  • احصل على النتائج عن طريق استدعاء الأسلوب SignApi.createSignatures()

يوضح مثال التعليمات البرمجية التالي كيفية توقيع مستند Word بالتوقيعات الرقمية باستخدام واجهة برمجة تطبيقات REST في Node.js.

// تهيئة api
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);

// إنشاء ملف معلومات
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// تحديد خيارات التوقيع الرقمي
let opts = new groupdocs_signature_cloud.SignDigitalOptions();
opts.signatureType = groupdocs_signature_cloud.OptionsBase.SignatureTypeEnum.Digital;
opts.imageFilePath = "signature.jpg";
opts.certificateFilePath = "certificate.pfx";
opts.password = "1234567890";

// تعيين موضع التوقيع على الصفحة
opts.left = 350;
opts.top = 450;
opts.width = 200;
opts.height = 100;
opts.location_measure_type = "Pixels";
opts.size_measure_type = "Pixels";
opts.rotation_angle = 0;
opts.horizontal_alignment = "None";
opts.vertical_alignment = "None";
opts.margin = new groupdocs_signature_cloud.Padding();
opts.margin.all = 5;
opts.margin_measure_type = "Pixels";

// اضبط الصفحة لإظهار التوقيعات
opts.page = 1;

// تحديد إعدادات التوقيع
let settings = new groupdocs_signature_cloud.SignSettings();
settings.fileInfo = fileInfo;
settings.options = [opts];

// تحديد خيارات الحفظ
settings.saveOptions = new groupdocs_signature_cloud.SaveOptions();
settings.saveOptions.outputFilePath = "signedDigital_sample.docx";

// إنشاء طلب توقيع
let request = new groupdocs_signature_cloud.CreateSignaturesRequest(settings);
let response = await signApi.createSignatures(request);

console.log("Output file link: " + response.downloadUrl);
قم بتوقيع مستندات Word بالتوقيعات الرقمية باستخدام Node.js

قم بتوقيع مستندات Word بالتوقيعات الرقمية باستخدام Node.js

قم بتنزيل الملف الموقّع

نموذج التعليمات البرمجية أعلاه سيحفظ ملف Word الموقع على السحابة. يمكنك تنزيله باستخدام نموذج التعليمات البرمجية الموضح أدناه:

// بناء FileApi
var fileApi = groupdocs_signature_cloud.FileApi.fromConfig(config);

// طلب إنشاء ملف تنزيل
let request = new groupdocs_signature_cloud.DownloadFileRequest("signedDigital_sample.docx", myStorage);
let response = await fileApi.downloadFile(request);

// احفظ الملف في دليل العمل
fs.writeFile("C:\\Files\\signedDigital_sample.docx", response, "binary", function (err) { });

قم بتوقيع مستندات PDF باستخدام التوقيعات الرقمية باستخدام Node.js

يمكنك توقيع مستندات PDF بالتوقيعات الرقمية برمجيًا باتباع الخطوات الواردة أدناه:

  • قم بإنشاء مثيل SignApi
  • قم بإنشاء مثيل FileInfo
  • قم بتعيين مسار ملف PDF
  • قم بإنشاء مثيل لـ SignDigitalOptions
  • اضبط SignatureType على Digital
  • قم بتعيين ImageFilePath و CertificateFilePath
  • أدخل كلمة المرور
  • قم بإنشاء مثيل SignSettings
  • قم بتعيين SignDigitalOptions و SaveOptions إلى SignSettings
  • قم بإنشاء CreateSignaturesRequest
  • احصل على النتائج عن طريق استدعاء الأسلوب SignApi.createSignatures()

يوضح مثال الكود التالي كيفية توقيع مستند PDF بالتوقيعات الرقمية باستخدام واجهة برمجة تطبيقات REST في Node.js.

// تهيئة api
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);

// إنشاء ملف معلومات
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";

// تحديد خيارات التوقيع الرقمي
let opts = new groupdocs_signature_cloud.SignDigitalOptions();
opts.signatureType = groupdocs_signature_cloud.OptionsBase.SignatureTypeEnum.Digital;
opts.imageFilePath = "signature.jpg";
opts.certificateFilePath = "certificate.pfx";
opts.password = "1234567890";
opts.allPage = true;

// تحديد خيارات التوقيع
let settings = new groupdocs_signature_cloud.SignSettings();
settings.fileInfo = fileInfo;
settings.options = [opts];

// تحديد خيارات الحفظ
settings.saveOptions = new groupdocs_signature_cloud.SaveOptions();
settings.saveOptions.outputFilePath = "signedDigital_sample.pdf";

// إنشاء طلب توقيع
let request = new groupdocs_signature_cloud.CreateSignaturesRequest(settings);
let response = await signApi.createSignatures(request);

console.log("Output file link: " + response.downloadUrl);
قم بتوقيع مستندات PDF باستخدام التوقيعات الرقمية باستخدام Node.js

قم بتوقيع مستندات PDF باستخدام التوقيعات الرقمية باستخدام Node.js

تحقق من التواقيع الرقمية باستخدام واجهة برمجة تطبيقات REST في Node.js

يمكنك بسهولة التحقق من التوقيعات الرقمية برمجيًا باتباع الخطوات الواردة أدناه:

  • قم بإنشاء مثيل SignApi
  • قم بإنشاء مثيل FileInfo
  • قم بتعيين مسار ملف DOCX
  • قم بإنشاء مثيل لـ theVerifyDigitalOptions
  • اضبط SignatureType على Digital
  • قم بإنشاء مثيل من VerifySettings
  • قم بتعيين VerifyDigitalOptions و FileInfo إلى VerifySettings
  • قم بإنشاء VerifySignaturesRequest
  • احصل على النتائج عن طريق استدعاء طريقة SignApi.verifySignatures()
  • اعرض النتائج

يوضح مثال الكود التالي كيفية التحقق من التوقيعات الرقمية باستخدام واجهة برمجة تطبيقات REST في Node.js.

// تهيئة api
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);

// إنشاء ملف معلومات
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "signedDigital_sample.docx";

// تحديد خيارات التحقق
let opts = new groupdocs_signature_cloud.VerifyDigitalOptions();
opts.signatureType = groupdocs_signature_cloud.OptionsBase.SignatureTypeEnum.Digital;

// تحديد التحقق من الإعدادات
let settings = new groupdocs_signature_cloud.VerifySettings();
settings.fileInfo = fileInfo;
settings.options = [opts];

// إنشاء طلب التحقق من التوقيع
let request = new groupdocs_signature_cloud.VerifySignaturesRequest(settings);
let response = await signApi.verifySignatures(request);

// أظهر النتائج
if (response.isSuccess) {
  console.log("Successfully verified!");
}
else{
  console.log("Not verified!");
}
تحقق من التواقيع الرقمية باستخدام واجهة برمجة تطبيقات REST في Node.js

تحقق من التواقيع الرقمية باستخدام واجهة برمجة تطبيقات REST في Node.js

جرب عبر الإنترنت

يرجى تجربة أداة توقيع المستندات المجانية التالية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/signature/

خاتمة

في هذه المقالة ، تعلمت كيفية توقيع مستندات Word بالتوقيعات الرقمية على السحابة. لقد تعلمت أيضًا كيفية توقيع مستندات PDF بالتوقيعات الرقمية باستخدام واجهة برمجة تطبيقات REST في Node.js. علاوة على ذلك ، تعلمت كيفية تحميل ملف Word برمجيًا على السحابة ثم تنزيل الملف الموقّع من السحابة. يمكنك معرفة المزيد حول GroupDocs.Signature Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، لا تتردد في الاتصال بنا على المنتدى.

أنظر أيضا