Електронні підписи такі ж прості, як ім’я, введене в електронні документи. Вони все частіше використовуються в електронній комерції та в нормативних документах. Електронні підписи представляють собою дані у візуально закодованій формі, яка використовується підписантом для електронного підпису документів. Як розробник Python ви можете програмно редагувати підписи у своїх підписаних PDF-документах у хмарі. У цій статті мова піде про те, як редагувати підписи в підписаних PDF-документах за допомогою REST API у Python.
У цій статті будуть розглянуті такі теми:
- API підпису документа REST і Python SDK
- Редагувати підписи в підписаних PDF-документах за допомогою REST API
- Пошук і заміна електронних підписів за допомогою Python
API підпису документа REST і Python SDK
Для редагування електронних підписів у PDF документі я буду використовувати API Python SDK GroupDocs.Signature Cloud. Він дає змогу електронно захищати документи та зображення для підтримуваних форматів файлів, застосовуючи текст, штамп, QR-код, штрих-код, зображення та цифрові підписи. Ви також можете легко створювати, перевіряти, видаляти та шукати різні типи підписів. Він також надає .NET, Java, PHP, Android, Ruby та Node.js SDK як члени сімейства підписів документів для Cloud API.
Ви можете встановити GroupDocs.Signature Cloud у свій проект Python за допомогою pip (інсталятор пакета для python), використовуючи таку команду в консолі:
pip install groupdocs_signature_cloud
Будь ласка, отримайте свій ідентифікатор клієнта та секрет клієнта з інформаційної панелі, перш ніж почати виконувати кроки та доступні приклади коду. Додайте свій ідентифікатор і секрет у код, як показано нижче:
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 = ""
Редагуйте підписи в підписаних PDF-документах за допомогою REST API у Python
Ви можете редагувати підписи в підписаних PDF-документах, виконавши прості дії, наведені нижче:
- Завантажте підписані файли PDF у хмару
- Оновлення підписів у підписаних PDF-документах за допомогою Python
- Завантажити отриманий файл
Завантажте документ
Перш за все, завантажте підписаний PDF-документ у хмару, використовуючи наведений нижче приклад коду:
# ініціалізація API
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)
# завантажити зразки файлів
request = groupdocs_signature_cloud.UploadFileRequest("signed.pdf", "C:\\Files\\signed.pdf", my_storage)
response = file_api.upload_file(request)
У результаті завантажений файл PDF (signed.pdf) буде доступний у розділі файлів вашої інформаційної панелі в хмарі.
Оновіть підписи в підписаних документах PDF за допомогою Python
Ви можете програмно оновити підписи в підписаному файлі PDF, виконавши наведені нижче дії.
- Створіть екземпляр SignApi
- Встановіть шлях до підписаного файлу PDF
- Шукайте QR-код за допомогою SearchQRCodeOptions і SearchSettings
- Створіть SearchSignatureRequest
- Отримайте результати, викликавши метод SignApi.search\signatures().
- Визначте UpdateOptions
- Встановіть UpdateSettings
- Призначте UpdateOptions до UpdateSettings
- Створіть UpdateSignaturesRequest
- Отримайте результати, викликавши метод SignApi.update\signatures().
У наведеному нижче фрагменті коду показано, як оновити підписи QR-коду в підписаному PDF-документі за допомогою REST API.
# ініціалізація API
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)
# шлях підписаного документа
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "signed.pdf"
# шукати 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)
# оновити 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)
Оновіть підписи в підписаному PDF-документі за допомогою Python
Завантажте підписаний файл
Наведений вище зразок коду збереже оновлений PDF-файл у хмарі, який можна завантажити за допомогою такого зразка коду:
# ініціалізація 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)
# Перемістіть завантажений файл у свій робочий каталог
shutil.move(response, "C:\\Files\\")
Пошук і заміна електронних підписів за допомогою Python
Ви можете шукати та замінювати підписи в підписаному PDF-документі програмним шляхом, виконавши наведені нижче дії.
- Створіть екземпляр SignApi
- Встановіть шлях до підписаного файлу PDF
- Пошук по QR-коду
- Визначте SearchQRCodeOptions і SearchSettings
- Створіть SearchSignatureRequest
- Отримайте результати, викликавши метод SignApi.search\signatures().
- Видаліть шуканий QR-код
- Визначте DeleteOptions і DeleteSettings
- Створіть DeleteSignatureRequest
- Отримайте результати, викликавши метод SignApi.delete\signatures().
- Знак зі штрих-кодом
- Визначте SignBarcodeOptions
- Встановіть розмір і положення штрих-коду
- Визначте SignSettings
- Призначте SignBarcodeOptions і SaveOptions для SignSettings
- Створіть CreateSignaturesRequest
- Отримайте результати, викликавши метод SignApi.create\signatures().
У наведеному нижче фрагменті коду показано, як шукати підпис QR-коду та замінювати його підписом штрих-коду в підписаному PDF-документі за допомогою REST API. Щоб завантажити оновлений файл, виконайте наведені раніше дії.
# ініціалізація API
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)
# Шлях документа з підписом qr-коду
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "signed.pdf"
# шукати 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)
# видалити 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)
# знак зі штрих-кодом
opts = groupdocs_signature_cloud.SignBarcodeOptions()
opts.signature_type = 'Barcode'
opts.text = '123456789012'
opts.barcode_type = 'Code128'
opts.code_text_alignment = 'None'
# встановити позицію підпису штрих-коду на сторінці
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)
Пошук і заміна підписів у підписаному PDF-документі за допомогою Python
Спробуйте онлайн
Будь ласка, спробуйте наведений нижче безкоштовний онлайн-інструмент для підписання PDF-файлів, розроблений за допомогою вищезгаданого API. https://products.groupdocs.app/signature/pdf
Висновок
У цій статті ви дізналися, як оновити підписи в підписаних документах PDF. Ви також дізналися, як шукати та замінювати підписи в підписаних документах PDF у хмарі. У цій статті також пояснюється, як програмним шляхом завантажити PDF-файл у хмару, а потім завантажити підписаний файл із хмари. Ви можете дізнатися більше про GroupDocs.Signature Cloud API, використовуючи документацію. Ми також надаємо розділ API Reference, який дозволяє візуалізувати наші API та взаємодіяти з ними безпосередньо через браузер. У разі будь-яких неясностей зв’яжіться з нами на форумі.