با استفاده از REST API در Node.js، اسناد را با امضاهای دیجیتال امضا کنید

می توانید اسناد خود را به صورت الکترونیکی با امضای دیجیتال به صورت برنامه ریزی شده در فضای ابری امضا کنید. از امضای دیجیتال برای تایید صحت و صحت اسناد استفاده می شود. همچنین شما را قادر می سازد تا کدی را به سند خود پیوست کنید که به عنوان امضا عمل می کند. این مقاله بر نحوه امضای اسناد با امضای دیجیتال با استفاده از REST API در Node.js تمرکز خواهد کرد.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

API REST امضای سند و Node.js SDK

برای امضای فایل‌های PDF و DOCX، از Node.js SDK of GroupDocs.Signature Cloud API استفاده خواهم کرد. این امکان را به شما می دهد تا انواع مختلفی از امضاها مانند تصویر، بارکد، کد QR، امضاهای مبتنی بر متن، دیجیتال و مهر را ایجاد، تأیید و جستجو کنید. این امضاها را می توان به راحتی در اسناد، صفحات گسترده، ارائه ها و تصاویر فرمت های فایل پشتیبانی شده قابل حمل یا ساده اعمال کرد. می توانید API را در برنامه های Node.js موجود خود ادغام کنید. همچنین SDK های دات نت، جاوا، PHP، اندروید، روبی و پایتون را به عنوان [اعضای خانواده امضای سند4 برای Cloud API فراهم می کند.

می توانید 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 API در Node.js امضا کنید

با دنبال کردن مراحل ساده زیر می‌توانید اسناد Word را با امضای دیجیتالی در Cloud امضا کنید:

سند را آپلود کنید

ابتدا سند 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 آپلود شده در بخش فایل‌ها داشبورد شما در فضای ابری در دسترس خواهد بود. لطفاً از نمونه کد بالا برای آپلود فایل تصویر گواهی و امضا در Cloud استفاده کنید.

با استفاده از Node.js اسناد Word را با امضاهای دیجیتال امضا کنید

با دنبال کردن مراحل زیر می‌توانید فایل‌های DOCX خود را با امضای دیجیتال به صورت برنامه‌نویسی امضا کنید:

  • یک نمونه از SignApi ایجاد کنید
  • یک نمونه از FileInfo ایجاد کنید
  • مسیر فایل DOCX را تنظیم کنید
  • یک نمونه از SignDigitalOptions ایجاد کنید
  • SignatureType را روی Digital قرار دهید
  • ImageFilePath و CertificateFilePath را تنظیم کنید
  • رمز عبور را ارائه دهید
  • موقعیت امضا را تنظیم کنید
  • یک نمونه از SignSettings ایجاد کنید
  • SignDigitalOptions و SaveOptions را به SignSettings اختصاص دهید
  • CreateSignaturesRequest را ایجاد کنید
  • با فراخوانی روش SignApi.createSignatures() نتایج را دریافت کنید

مثال کد زیر نحوه امضای سند Word را با امضای دیجیتال با استفاده از REST API در 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);
با استفاده از Node.js اسناد Word را با امضاهای دیجیتال امضا کنید

با استفاده از Node.js اسناد Word را با امضاهای دیجیتال امضا کنید

فایل امضا شده را دانلود کنید

نمونه کد بالا فایل 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) { });

با استفاده از Node.js اسناد PDF را با امضای دیجیتال امضا کنید

با دنبال کردن مراحل زیر می توانید اسناد PDF را با امضای دیجیتال به صورت برنامه ریزی شده امضا کنید:

  • یک نمونه از SignApi ایجاد کنید
  • یک نمونه از FileInfo ایجاد کنید
  • مسیر فایل PDF را تنظیم کنید
  • یک نمونه از SignDigitalOptions ایجاد کنید
  • SignatureType را روی Digital قرار دهید
  • ImageFilePath و CertificateFilePath را تنظیم کنید
  • رمز عبور را ارائه دهید
  • یک نمونه از SignSettings ایجاد کنید
  • SignDigitalOptions و SaveOptions را به SignSettings اختصاص دهید
  • CreateSignaturesRequest را ایجاد کنید
  • با فراخوانی روش SignApi.createSignatures() به نتیجه برسید

مثال کد زیر نحوه امضای یک سند PDF را با امضای دیجیتال با استفاده از REST API در 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);
با استفاده از Node.js اسناد PDF را با امضای دیجیتال امضا کنید

با استفاده از Node.js اسناد PDF را با امضای دیجیتال امضا کنید

امضاهای دیجیتال را با استفاده از REST API در Node.js تأیید کنید

با دنبال کردن مراحل زیر می توانید به راحتی امضاهای دیجیتال را به صورت برنامه ریزی شده تأیید کنید:

  • یک نمونه از SignApi ایجاد کنید
  • یک نمونه از FileInfo ایجاد کنید
  • مسیر فایل DOCX را تنظیم کنید
  • یک نمونه از theVerifyDigitalOptions ایجاد کنید
  • SignatureType را روی Digital قرار دهید
  • یک نمونه از VerifySettings ایجاد کنید
  • VerifyDigitalOptions و FileInfo را به VerifySettings اختصاص دهید
  • VerifySignaturesRequest را ایجاد کنید
  • با فراخوانی روش SignApi.verifySignatures() نتایج را دریافت کنید
  • نتایج را نشان دهید

مثال کد زیر نحوه تأیید امضای دیجیتال را با استفاده از REST API در 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 API در Node.js تأیید کنید

امضاهای دیجیتال را با استفاده از REST API در Node.js تأیید کنید

آنلاین را امتحان کنید

لطفاً ابزار امضای اسناد آنلاین رایگان زیر را که با استفاده از API بالا ایجاد شده است، امتحان کنید. https://products.groupdocs.app/signature/

نتیجه

در این مقاله یاد گرفتید که چگونه اسناد Word را با امضای دیجیتال در فضای ابری امضا کنید. همچنین یاد گرفته‌اید که چگونه اسناد PDF را با امضای دیجیتال با استفاده از REST API در Node.js امضا کنید. علاوه بر این، شما یاد گرفته‌اید که چگونه یک فایل Word را به صورت برنامه‌نویسی بر روی ابر آپلود کنید و سپس فایل امضا شده را از ابر دانلود کنید. می توانید با استفاده از مستندات درباره GroupDocs.Signature Cloud API بیشتر بیاموزید. ما همچنین یک بخش API Reference ارائه می دهیم که به شما امکان می دهد API های ما را مستقیماً از طریق مرورگر تجسم کنید و با آنها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در [تالار] تماس حاصل فرمایید15.

همچنین ببینید