Вы можете программно подписывать свои PDF-документы с помощью QR-кода в облаке. Цифровые подписи имеют такой же юридический статус, что и собственноручная подпись, если они соответствуют требованиям конкретного нормативного акта. В этой статье основное внимание будет уделено тому, как подписывать PDF-документы с помощью QR-кода с использованием REST API в Python.
В этой статье должны быть раскрыты следующие темы:
- Подпись документа REST API и Python SDK
- Подписывайте PDF-документы с помощью REST API
- Проверка электронных подписей с помощью Python
Подпись документа REST API и Python SDK
Для электронной подписи PDF я буду использовать API Python SDK of GroupDocs.Signature Cloud. Он позволяет создавать, проверять и искать различные типы подписей в переносимых или простых документах, электронных таблицах, презентациях и изображениях для поддерживаемых форматов файлов. Он также предоставляет SDK для .NET, Java, PHP, Android, Ruby и Node.js в качестве членов семейства подписей документов для 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-документы с помощью QR-кода, выполнив простые шаги, указанные ниже:
- Загрузить PDF-файлы в облако
- Подписать PDF-документ в Python
- Скачать результирующий файл
Загрузить документ
Прежде всего, загрузите документ PDF в облако, используя приведенный ниже пример кода:
# инициализация API
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)
# загрузить образцы файлов
request = groupdocs_signature_cloud.UploadFileRequest("sample.pdf", "C:\\Files\\sample.pdf", my_storage)
response = file_api.upload_file(request)
В результате загруженный PDF-файл (sample.pdf) будет доступен в разделе файлов вашей панели инструментов в облаке.
Подписывайте PDF-документы с помощью QR-кода с помощью Python
Пожалуйста, следуйте шагам, указанным ниже, чтобы подписать файл PDF программно.
- Создайте экземпляр SignApi
- Установите путь к файлу PDF
- Определить SignQRCodeOptions
- Установите тип подписи, текст и код
- Установить позицию подписи
- Определить настройки знака
- Назначьте SignQRCodeOptions и SaveOptions для SignSettings
- Создать CreateSignaturesRequest
- Получите результаты, вызвав метод SignApi.create\signatures().
В следующем фрагменте кода показано, как подписать документ PDF с помощью REST API.
# инициализация API
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "sample.pdf"
opts = groupdocs_signature_cloud.SignQRCodeOptions()
opts.signature_type = 'QRCode'
opts.text = 'GroupDocs.Signature Cloud'
opts.qr_code_type = 'Aztec'
# установить положение подписи на странице
opts.left = 450
opts.top = 0
opts.width = 90
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\\signedQRCode_sample.pdf"
settings.file_info = fileInfo
request = groupdocs_signature_cloud.CreateSignaturesRequest(settings)
response = api.create_signatures(request)
Подписывайте PDF-документы с помощью QR-кода
Загрузите подписанный файл
Приведенный выше пример кода сохранит подписанный PDF-файл в облаке. Вы можете загрузить его, используя следующий пример кода:
# инициализация API
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)
request = groupdocs_signature_cloud.DownloadFileRequest("Output\\signedQRCode_sample.pdf", my_storage)
response = file_api.download_file(request)
# Переместите загруженный файл в свой рабочий каталог
shutil.move(response, "C:\\Files\\")
Проверка электронных подписей с помощью Python
Выполните шаги, указанные ниже, чтобы программно проверить подписи в PDF-документе, подписанном с помощью QR-кода.
- Создайте экземпляр SignApi
- Установите путь к файлу PDF
- Определить VerifyQRCodeOptions
- Укажите тип подписи, текст и код
- Определить VerifySettings
- Назначьте VerifyQRCodeOptions и FileInfo для VerifySettings
- Создать VerifySignatureRequest
- Получите результаты, вызвав метод SignApi.verify\signatures().
В следующем фрагменте кода показано, как проверить подписи в документе PDF с помощью REST API.
# инициализация API
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "Output\\signedQRCode_sample.pdf"
opts = groupdocs_signature_cloud.VerifyQRCodeOptions()
opts.signature_type = 'QRCode'
opts.text = 'GroupDocs.Signature Cloud'
opts.qr_code_type = 'Aztec'
opts.match_type = 'Contains'
opts.page = 1
settings = groupdocs_signature_cloud.VerifySettings()
settings.options = [opts]
settings.file_info = fileInfo
request = groupdocs_signature_cloud.VerifySignaturesRequest(settings)
response = api.verify_signatures(request)
print('Signature Verified: ' + str(response.is_success))
Попробуйте онлайн
Попробуйте следующий бесплатный онлайн-инструмент для подписи PDF-файлов, разработанный с использованием вышеуказанного API. https://products.groupdocs.app/signature/pdf
Заключение
В этой статье вы узнали, как подписывать PDF-документы в облаке с помощью Document Signature REST API с использованием Python. Вы также узнали, как программно загрузить PDF-файл в облако, а затем загрузить подписанный файл из облака. Вы можете узнать больше о GroupDocs.Signature Cloud API, используя документацию. Мы также предоставляем раздел Справочник по API, который позволяет визуализировать наши API и взаимодействовать с ними непосредственно через браузер. В случае возникновения каких-либо неясностей, пожалуйста, свяжитесь с нами на форуме.