Podpisy elektroniczne są tak proste, jak imię i nazwisko wpisywane w dokumentach elektronicznych. Są one coraz częściej wykorzystywane w handlu elektronicznym oraz w zgłoszeniach regulacyjnych. Podpisy elektroniczne reprezentują dane w postaci zakodowanej wizualnie, używanej przez sygnatariusza do elektronicznego podpisywania dokumentów. Jako programista Python możesz elektronicznie edytować podpisy w podpisanych dokumentach PDF programowo w chmurze. W tym artykule skupimy się na tym, jak edytować podpisy w podpisanych dokumentach PDF za pomocą interfejsu API REST w języku Python.
W tym artykule zostaną omówione następujące tematy:
- Interfejs API REST podpisu dokumentu i zestaw SDK języka Python
- Edytuj podpisy w podpisanych dokumentach PDF za pomocą interfejsu API REST
- Wyszukaj i zastąp podpisy elektroniczne za pomocą Python
Interfejs API REST podpisu dokumentu i zestaw SDK języka Python
Do edytowania podpisów elektronicznych w dokumencie PDF będę używać API Python SDK of GroupDocs.Signature Cloud. Umożliwia elektroniczne zabezpieczenie dokumentów i obrazów dla obsługiwanych formatów plików poprzez zastosowanie tekstu, stempla, kodu QR, kodu kreskowego, obrazu i podpisów cyfrowych. Możesz także łatwo tworzyć, weryfikować, usuwać i wyszukiwać różne rodzaje podpisów. Udostępnia również zestawy SDK .NET, Java, PHP, Android, Ruby i Node.js jako członkowie rodziny podpisów dokumentów dla Cloud API.
Możesz zainstalować GroupDocs.Signature Cloud w swoim projekcie Python za pomocą pip (package installer for python), używając następującego polecenia w konsoli:
pip install groupdocs_signature_cloud
Zanim zaczniesz postępować zgodnie z instrukcjami i dostępnymi przykładami kodu, uzyskaj swój identyfikator klienta i klucz tajny klienta z panelu nawigacyjnego. Dodaj swój identyfikator i klucz tajny w kodzie, jak pokazano poniżej:
client_id = "112f0f38-9dae-42d5-b4fc-cc84ae644972"
client_secret = "16ad3fe0bdc39c910f57d2fd48a5d618"
configuration = groupdocs_signature_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""
Edytuj podpisy w podpisanych dokumentach PDF za pomocą interfejsu API REST w języku Python
Możesz edytować podpisy w podpisanych dokumentach PDF, wykonując proste czynności wymienione poniżej:
- Prześlij podpisane pliki PDF do chmury
- Aktualizacja podpisów w podpisanych dokumentach PDF przy użyciu języka Python
- Pobierz wynikowy plik
Prześlij dokument
Przede wszystkim prześlij podpisany dokument PDF do chmury, korzystając z przykładowego kodu podanego poniżej:
# inicjalizacja API
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)
# wgraj przykładowe pliki
request = groupdocs_signature_cloud.UploadFileRequest("signed.pdf", "C:\\Files\\signed.pdf", my_storage)
response = file_api.upload_file(request)
W rezultacie przesłany plik PDF (signed.pdf) będzie dostępny w sekcji plików Twojego pulpitu nawigacyjnego w chmurze.
Zaktualizuj podpisy w podpisanych dokumentach PDF za pomocą języka Python
Podpisy w podpisanym pliku PDF można aktualizować programowo, wykonując czynności wymienione poniżej.
- Utwórz instancję SignApi
- Ustaw ścieżkę do podpisanego pliku PDF
- Wyszukaj kod QR, podając SearchQRCodeOptions i SearchSettings
- Utwórz SearchSignatureRequest
- Uzyskaj wyniki, wywołując metodę SignApi.search\signatures().
- Zdefiniuj opcje aktualizacji
- Ustaw ustawienia aktualizacji
- Przypisz UpdateOptions do UpdateSettings
- Utwórz UpdateSignaturesRequest
- Uzyskaj wyniki, wywołując metodę SignApi.update\signatures().
Poniższy fragment kodu pokazuje, jak zaktualizować podpisy kodu QR w podpisanym dokumencie PDF przy użyciu interfejsu API REST.
# inicjalizacja API
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)
# podpisana ścieżka dokumentu
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "signed.pdf"
# wyszukaj kod qr
opts = groupdocs_signature_cloud.SearchQRCodeOptions()
opts.page = 1
opts.signature_type = 'QRCode'
settings = groupdocs_signature_cloud.SearchSettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.SearchSignaturesRequest(settings)
response = api.search_signatures(request)
# zaktualizuj kod QR
opts = groupdocs_signature_cloud.UpdateOptions()
opts.page = 1
opts.signature_type = 'QRCode'
opts.signature_id = response.signatures[0].signature_id
opts.left = 450
opts.top = 600
opts.width = 90
opts.height = 90
opts.is_signature = True
settings = groupdocs_signature_cloud.UpdateSettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.UpdateSignaturesRequest(settings)
response = api.update_signatures(request)
Zaktualizuj podpisy w podpisanym dokumencie PDF za pomocą języka Python
Pobierz podpisany plik
Powyższy przykładowy kod zapisze zaktualizowany plik PDF w chmurze, który można pobrać za pomocą następującego przykładowego kodu:
# inicjalizacja API
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)
request = groupdocs_signature_cloud.DownloadFileRequest("signed.pdf", my_storage)
response = file_api.download_file(request)
# Przenieś pobrany plik do katalogu roboczego
shutil.move(response, "C:\\Files\\")
Wyszukaj i zastąp podpisy elektroniczne za pomocą Python
Możesz wyszukiwać i zamieniać podpisy w podpisanym dokumencie PDF programowo, wykonując czynności podane poniżej.
- Utwórz instancję SignApi
- Ustaw ścieżkę do podpisanego pliku PDF
- Wyszukaj kod QR
- Zdefiniuj SearchQRCodeOptions i SearchSettings
- Utwórz SearchSignatureRequest
- Uzyskaj wyniki, wywołując metodę SignApi.search\signatures().
- Usuń wyszukany kod QR
- Zdefiniuj opcje DeleteOptions i DeleteSettings
- Utwórz żądanie DeleteSignatureRequest
- Uzyskaj wyniki, wywołując metodę SignApi.delete\signatures().
- Znak z kodem kreskowym
- Zdefiniuj opcje SignBarcode
- Ustaw rozmiar i położenie kodu kreskowego
- Zdefiniuj ustawienia znaku
- Przypisz SignBarcodeOptions i SaveOptions do SignSettings
- Utwórz CreateSignaturesRequest
- Uzyskaj wyniki, wywołując metodę SignApi.create\signatures().
Poniższy fragment kodu pokazuje, jak wyszukać podpis kodu QR i zastąpić go podpisem kodu kreskowego w podpisanym dokumencie PDF przy użyciu interfejsu API REST. Wykonaj czynności wymienione wcześniej, aby pobrać zaktualizowany plik.
# inicjalizacja API
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)
# ścieżka dokumentu podpisanego kodem qr
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "signed.pdf"
# wyszukaj kod qr
opts = groupdocs_signature_cloud.SearchQRCodeOptions()
opts.page = 1
opts.signature_type = 'QRCode'
settings = groupdocs_signature_cloud.SearchSettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.SearchSignaturesRequest(settings)
response = api.search_signatures(request)
# usuń kod qr
opts = groupdocs_signature_cloud.DeleteOptions()
opts.page = 1
opts.signature_type = 'QRCode'
opts.signature_id = response.signatures[0].signature_id
settings = groupdocs_signature_cloud.DeleteSettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.DeleteSignaturesRequest(settings)
response = api.delete_signatures(request)
# znak z kodem kreskowym
opts = groupdocs_signature_cloud.SignBarcodeOptions()
opts.signature_type = 'Barcode'
opts.text = '123456789012'
opts.barcode_type = 'Code128'
opts.code_text_alignment = 'None'
# ustawić pozycję podpisu kodu kreskowego na stronie
opts.left = 250
opts.top = 0
opts.width = 300
opts.height = 90
opts.location_measure_type = "Pixels"
opts.size_measure_type = "Pixels"
opts.stretch = "None"
opts.rotation_angle = 0
opts.horizontal_alignment = "None"
opts.vertical_alignment = "None"
opts.margin = groupdocs_signature_cloud.Padding()
opts.margin.all = 5
opts.margin_measure_type = "Pixels"
opts.inner_margins = groupdocs_signature_cloud.Padding()
opts.inner_margins.all = 2
opts.page = 1
settings = groupdocs_signature_cloud.SignSettings()
settings.options = [opts]
settings.save_options = groupdocs_signature_cloud.SaveOptions()
settings.save_options.output_file_path = "Output\\signedBarCode_sample.pdf"
settings.file_info = fileInfo
request = groupdocs_signature_cloud.CreateSignaturesRequest(settings)
response = api.create_signatures(request)
Wyszukaj i zamień podpisy w podpisanym dokumencie PDF za pomocą Python
Wypróbuj online
Wypróbuj następujące bezpłatne narzędzie do podpisu PDF online, które zostało opracowane przy użyciu powyższego interfejsu API. https://products.groupdocs.app/signature/pdf
Wniosek
W tym artykule nauczyłeś się aktualizować podpisy w podpisanych dokumentach PDF. Dowiedziałeś się również, jak wyszukiwać i zastępować podpisy w podpisanych dokumentach PDF w chmurze. W tym artykule wyjaśniono również, jak programowo przesłać plik PDF 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.