Você pode assinar eletronicamente seus documentos PDF com código QR programaticamente na nuvem. A assinatura digital confere o mesmo valor jurídico da assinatura manuscrita, desde que atenda aos requisitos da regulamentação específica. Este artigo se concentrará em como assinar documentos PDF com QR Code usando uma API REST em Python.

Os seguintes tópicos serão abordados neste artigo:

API REST de assinatura de documento e SDK Python

groupdocssignature-for-cloud

Para assinatura eletrônica PDF, usarei a API Python SDK of GroupDocs.Signature Cloud. Ele permite que você crie, verifique e pesquise diferentes tipos de assinaturas em documentos portáteis ou simples, planilhas, apresentações e imagens para formatos de arquivo suportados. Ele também fornece SDKs .NET, Java, PHP, Android, Ruby e Node.js como seus membros da família de assinatura de documento para a Cloud API.

Você pode instalar o GroupDocs.Signature Cloud em seu projeto Python com pip (package installer for python) usando o seguinte comando no console:

pip install groupdocs_signature_cloud

Obtenha seu ID de cliente e Segredo do cliente no painel antes de começar a seguir as etapas e os exemplos de código disponíveis. Adicione seu ID e segredo no código conforme demonstrado abaixo:

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

Assinar documentos PDF usando uma API REST em Python

Você pode assinar documentos PDF com QR Code seguindo as etapas simples mencionadas abaixo:

Carregue o Documento

Em primeiro lugar, carregue o documento PDF na nuvem usando o exemplo de código abaixo:

# inicialização da API
file_api = groupdocs_signature_cloud.FileApi.from_config(configuration)

# fazer upload de arquivos de amostra
request = groupdocs_signature_cloud.UploadFileRequest("sample.pdf", "C:\\Files\\sample.pdf", my_storage)
response = file_api.upload_file(request)

Como resultado, o arquivo PDF carregado (sample.pdf) estará disponível na seção de arquivos do seu painel na nuvem.

Assinar documentos PDF com QR Code usando Python

Siga as etapas mencionadas abaixo para assinar o arquivo PDF programaticamente.

  • Crie uma instância de SignApi
  • Definir o caminho do arquivo PDF
  • Definir SignQRCodeOptions
  • Definir tipo de assinatura, texto e código
  • Definir posição de assinatura
  • Definir SignSettings
  • Atribuir SignQRCodeOptions e SaveOptions a SignSettings
  • Criar CreateSignaturesRequest
  • Obtenha resultados chamando o método SignApi.create\signatures()

O trecho de código a seguir mostra como assinar um documento PDF usando uma API REST.

# inicialização da 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'

# definir a posição da assinatura em uma página
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)
Assinar documentos PDF com QR Code

Assinar documentos PDF com QR Code

Baixe o arquivo assinado

O exemplo de código acima salvará o arquivo PDF assinado na nuvem. Você pode baixá-lo usando o seguinte exemplo de código:

# inicialização da 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)

# Mova o arquivo baixado para o seu diretório de trabalho
shutil.move(response, "C:\\Files\\")

Verifique as assinaturas eletrônicas usando Python

Siga as etapas mencionadas abaixo para verificar as assinaturas de um documento PDF assinado com código QR programaticamente.

  • Crie uma instância de SignApi
  • Definir o caminho do arquivo PDF
  • Definir opções de verificação de QRCode
  • Forneça tipo de assinatura, texto e código
  • Definir configurações de verificação
  • Atribuir VerifyQRCodeOptions e FileInfo para VerifySettings
  • Criar VerifySignatureRequest
  • Obtenha resultados chamando o método SignApi.verify\signatures()

O trecho de código a seguir mostra como verificar as assinaturas em um documento PDF usando uma API REST.

# inicialização da 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))

Experimente on-line

Experimente a seguinte ferramenta de assinatura de PDF on-line gratuita, desenvolvida usando a API acima. https://products.groupdocs.app/signature/pdf

Conclusão

Neste artigo, você aprendeu como assinar documentos PDF na nuvem com a API REST de assinatura de documento usando Python. Você também aprendeu como carregar programaticamente um arquivo PDF na nuvem e, em seguida, baixar o arquivo assinado da nuvem. Você pode aprender mais sobre GroupDocs.Signature Cloud API usando a documentação. Também fornecemos uma seção Referência de API que permite visualizar e interagir com nossas APIs diretamente pelo navegador. Em caso de ambiguidade, sinta-se à vontade para nos contatar no fórum.

Veja também