Podpisuj dokumenty za pomocą podpisów cyfrowych za pomocą REST API w Node.js

Możesz elektronicznie podpisywać swoje dokumenty za pomocą podpisów cyfrowych programowo w chmurze. Podpisy cyfrowe służą do sprawdzania autentyczności i integralności dokumentów. Umożliwia również dołączenie do dokumentu kodu, który pełni rolę podpisu. Ten artykuł skupi się na tym, jak podpisywać dokumenty podpisami cyfrowymi przy użyciu interfejsu API REST w Node.js.

W tym artykule zostaną omówione następujące tematy:

Interfejs API REST podpisu dokumentu i zestaw SDK Node.js

Do podpisywania plików PDF i DOCX będę używać API Node.js SDK of GroupDocs.Signature Cloud. Umożliwia tworzenie, weryfikowanie i wyszukiwanie różnego rodzaju podpisów, takich jak podpisy graficzne, kody kreskowe, QR-Code, podpisy tekstowe, cyfrowe i pieczątkowe. Podpisy te można łatwo zastosować w przenośnych lub prostych dokumentach, arkuszach kalkulacyjnych, prezentacjach i obrazach w obsługiwanych formatach plików. Interfejs API można zintegrować z istniejącymi aplikacjami Node.js. Udostępnia również zestawy SDK .NET, Java, PHP, Android, Ruby i Python jako członkowie rodziny podpisów dokumentów dla Cloud API.

Możesz zainstalować GroupDocs.Signature Cloud w swoim projekcie Node.js za pomocą następującego polecenia w konsoli:

npm install groupdocs-signature-cloud --save

Przed wykonaniem wspomnianych kroków uzyskaj swój identyfikator klienta i klucz tajny z panelu nawigacyjnego. Po uzyskaniu identyfikatora i tajnego kodu dodaj kod, jak pokazano poniżej:

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";

Podpisuj dokumenty Word za pomocą interfejsu API REST w Node.js

Możesz podpisywać dokumenty programu Word za pomocą podpisów cyfrowych w chmurze, wykonując proste czynności wymienione poniżej:

Prześlij dokument

Najpierw prześlij dokument programu Word do chmury, korzystając z przykładowego kodu podanego poniżej:

var resourcesFolder = 'C:\\Files\\sample.docx';
fs.readFile(resourcesFolder, (err, fileStream) => {
  // skonstruuj FileApi
  var fileApi = groupdocs_signature_cloud.FileApi.fromConfig(config);
  // utwórz żądanie przesłania pliku
  var request = new groupdocs_signature_cloud.UploadFileRequest("sample.docx", fileStream, myStorage);
  fileApi.uploadFile(request)
});

W rezultacie przesłany plik Word będzie dostępny w sekcji plików pulpitu nawigacyjnego w chmurze. Użyj powyższego przykładowego kodu, aby przesłać plik obrazu certyfikatu i podpisu do chmury.

Podpisuj dokumenty Word za pomocą podpisów cyfrowych za pomocą Node.js

Możesz programowo podpisywać swoje pliki DOCX podpisami cyfrowymi, wykonując czynności podane poniżej:

  • Utwórz wystąpienie SignApi
  • Utwórz instancję FileInfo
  • Ustaw ścieżkę pliku DOCX
  • Utwórz instancję SignDigitalOptions
  • Ustaw SignatureType na Digital
  • Ustaw ImageFilePath i CertificateFilePath
  • Podaj hasło
  • Ustaw pozycję podpisu
  • Utwórz instancję SignSettings
  • Przypisz SignDigitalOptions i SaveOptions do SignSettings
  • Utwórz CreateSignaturesRequest
  • Uzyskaj wyniki, wywołując metodę SignApi.createSignatures().

Poniższy przykład kodu pokazuje, jak podpisać dokument programu Word za pomocą podpisów cyfrowych przy użyciu interfejsu API REST w Node.js.

// zainicjować api
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);

// utwórz informacje o pliku
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// zdefiniuj opcje cyfrowe znaku
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";

// ustawić pozycję podpisu na stronie
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";

// ustaw stronę, aby pokazać podpisy
opts.page = 1;

// zdefiniuj ustawienia znaku
let settings = new groupdocs_signature_cloud.SignSettings();
settings.fileInfo = fileInfo;
settings.options = [opts];

// zdefiniuj opcje zapisu
settings.saveOptions = new groupdocs_signature_cloud.SaveOptions();
settings.saveOptions.outputFilePath = "signedDigital_sample.docx";

// utwórz prośbę o podpis
let request = new groupdocs_signature_cloud.CreateSignaturesRequest(settings);
let response = await signApi.createSignatures(request);

console.log("Output file link: " + response.downloadUrl);
Podpisuj dokumenty Word za pomocą podpisów cyfrowych za pomocą Node.js

Podpisuj dokumenty Word za pomocą podpisów cyfrowych za pomocą Node.js

Pobierz podpisany plik

Powyższy przykładowy kod zapisze podpisany plik Word w chmurze. Możesz go pobrać, korzystając z przykładowego kodu podanego poniżej:

// skonstruuj FileApi
var fileApi = groupdocs_signature_cloud.FileApi.fromConfig(config);

// utwórz żądanie pobrania pliku
let request = new groupdocs_signature_cloud.DownloadFileRequest("signedDigital_sample.docx", myStorage);
let response = await fileApi.downloadFile(request);

// zapisz plik w katalogu roboczym
fs.writeFile("C:\\Files\\signedDigital_sample.docx", response, "binary", function (err) { });

Podpisuj dokumenty PDF za pomocą podpisów cyfrowych za pomocą Node.js

Możesz programowo podpisywać dokumenty PDF podpisami cyfrowymi, wykonując poniższe czynności:

  • Utwórz wystąpienie SignApi
  • Utwórz instancję FileInfo
  • Ustaw ścieżkę pliku PDF
  • Utwórz instancję SignDigitalOptions
  • Ustaw SignatureType na Digital
  • Ustaw ImageFilePath i CertificateFilePath
  • Podaj hasło
  • Utwórz instancję SignSettings
  • Przypisz SignDigitalOptions i SaveOptions do SignSettings
  • Utwórz CreateSignaturesRequest
  • Uzyskaj wyniki, wywołując metodę SignApi.createSignatures().

Poniższy przykład kodu pokazuje, jak podpisać dokument PDF za pomocą podpisów cyfrowych przy użyciu interfejsu API REST w Node.js.

// zainicjować api
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);

// utwórz informacje o pliku
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";

// zdefiniuj opcje cyfrowe znaku
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;

// zdefiniuj opcje znaku
let settings = new groupdocs_signature_cloud.SignSettings();
settings.fileInfo = fileInfo;
settings.options = [opts];

// zdefiniuj opcje zapisu
settings.saveOptions = new groupdocs_signature_cloud.SaveOptions();
settings.saveOptions.outputFilePath = "signedDigital_sample.pdf";

// utwórz prośbę o podpis
let request = new groupdocs_signature_cloud.CreateSignaturesRequest(settings);
let response = await signApi.createSignatures(request);

console.log("Output file link: " + response.downloadUrl);
Podpisuj dokumenty PDF za pomocą podpisów cyfrowych za pomocą Node.js

Podpisuj dokumenty PDF za pomocą podpisów cyfrowych za pomocą Node.js

Weryfikuj podpisy cyfrowe za pomocą interfejsu API REST w Node.js

Podpisy cyfrowe można łatwo zweryfikować programowo, wykonując poniższe czynności:

  • Utwórz wystąpienie SignApi
  • Utwórz instancję FileInfo
  • Ustaw ścieżkę pliku DOCX
  • Utwórz instancję VerifyDigitalOptions
  • Ustaw SignatureType na Digital
  • Utwórz instancję VerifySettings
  • Przypisz VerifyDigitalOptions i FileInfo do VerifySettings
  • Utwórz VerifySignaturesRequest
  • Uzyskaj wyniki, wywołując metodę SignApi.verifySignatures().
  • Pokaż wyniki

Poniższy przykład kodu pokazuje, jak weryfikować podpisy cyfrowe przy użyciu interfejsu API REST w Node.js.

// zainicjować api
let signApi = groupdocs_signature_cloud.SignApi.fromKeys(clientId, clientSecret);

// utwórz informacje o pliku
let fileInfo = new groupdocs_signature_cloud.FileInfo();
fileInfo.filePath = "signedDigital_sample.docx";

// zdefiniuj opcje weryfikacji
let opts = new groupdocs_signature_cloud.VerifyDigitalOptions();
opts.signatureType = groupdocs_signature_cloud.OptionsBase.SignatureTypeEnum.Digital;

// zdefiniuj ustawienia weryfikacji
let settings = new groupdocs_signature_cloud.VerifySettings();
settings.fileInfo = fileInfo;
settings.options = [opts];

// utwórz prośbę o weryfikację podpisu
let request = new groupdocs_signature_cloud.VerifySignaturesRequest(settings);
let response = await signApi.verifySignatures(request);

// Pokaż wyniki
if (response.isSuccess) {
  console.log("Successfully verified!");
}
else{
  console.log("Not verified!");
}
Weryfikuj podpisy cyfrowe za pomocą interfejsu API REST w Node.js

Weryfikuj podpisy cyfrowe za pomocą interfejsu API REST w Node.js

Wypróbuj online

Wypróbuj następujące bezpłatne narzędzie do podpisywania dokumentów online, które zostało opracowane przy użyciu powyższego interfejsu API. https://products.groupdocs.app/signature/

Wniosek

W tym artykule nauczyłeś się podpisywać dokumenty programu Word za pomocą podpisów cyfrowych w chmurze. Nauczyłeś się również podpisywać dokumenty PDF podpisami cyfrowymi za pomocą REST API w Node.js. Ponadto nauczyłeś się, jak programowo przesłać plik Word do chmury, a następnie pobrać podpisany plik z chmury. Możesz dowiedzieć się więcej o GroupDocs.Signature Cloud API korzystając z dokumentacji. Udostępniamy również sekcję Informacje o interfejsach API, która umożliwia wizualizację naszych interfejsów API i interakcję z nimi bezpośrednio w przeglądarce. W przypadku jakichkolwiek niejasności prosimy o kontakt na forum.

Zobacz też