As assinaturas eletrônicas são tão simples quanto um nome inserido em documentos eletrônicos. Eles são cada vez mais usados no comércio eletrônico e em registros regulatórios. As assinaturas eletrônicas representam os dados no formulário visualmente codificado usado pelo signatário para assinar os documentos eletronicamente. Como desenvolvedor Python, você pode editar eletronicamente assinaturas em seus documentos PDF assinados programaticamente na nuvem. Este artigo se concentrará em como editar assinaturas em documentos PDF assinados 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 editar assinaturas eletrônicas em um documento PDF, usarei a API Python SDK of GroupDocs.Signature Cloud. Ele permite que você proteja eletronicamente documentos e imagens para formatos de arquivo suportados, aplicando texto, carimbo, código QR, código de barras, imagem e assinaturas digitais. Você também pode criar, verificar, excluir e pesquisar facilmente diferentes tipos de assinaturas. 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 = ""

Editar assinaturas em documentos PDF assinados usando uma API REST em Python

Você pode editar assinaturas em documentos PDF assinados seguindo as etapas simples mencionadas abaixo:

Carregue o Documento

Em primeiro lugar, carregue o documento PDF assinado 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("signed.pdf", "C:\\Files\\signed.pdf", my_storage)
response = file_api.upload_file(request)

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

Atualizar assinaturas em documentos PDF assinados usando Python

Você pode atualizar as assinaturas em um arquivo PDF assinado programaticamente seguindo as etapas mencionadas abaixo.

  • Crie uma instância de SignApi
  • Defina o caminho para o arquivo PDF assinado
  • Pesquise QR Code fornecendo SearchQRCodeOptions e SearchSettings
  • Criar SearchSignatureRequest
  • Obtenha resultados chamando o método SignApi.search\signatures()
  • Definir opções de atualização
  • Definir configurações de atualização
  • Atribuir UpdateOptions a UpdateSettings
  • Criar UpdateSignaturesRequest
  • Obtenha resultados chamando o método SignApi.update\signatures()

O trecho de código a seguir mostra como atualizar as assinaturas do QR Code em um documento PDF assinado usando uma API REST.

# inicialização da API
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)

# caminho do documento assinado
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "signed.pdf"

# pesquisar código 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)

# atualize o código 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)
Atualizar assinaturas em documento PDF assinado usando Python

Atualizar assinaturas em documento PDF assinado usando Python

Baixe o arquivo assinado

O exemplo de código acima salvará o arquivo PDF atualizado na nuvem, que pode ser baixado 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("signed.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\\")

Pesquise e substitua assinaturas eletrônicas usando Python

Você pode pesquisar e substituir as assinaturas em um documento PDF assinado programaticamente seguindo as etapas abaixo.

  • Crie uma instância de SignApi
  • Defina o caminho para o arquivo PDF assinado
  • Pesquisar código QR
    • Defina SearchQRCodeOptions e SearchSettings
    • Criar SearchSignatureRequest
    • Obtenha resultados chamando o método SignApi.search\signatures()
  • Excluir o código QR pesquisado
  • Assinar com código de barras
    • Definir SignBarcodeOptions
    • Definir tamanho e posição do código de barras
    • Definir SignSettings
    • Atribuir SignBarcodeOptions e SaveOptions a SignSettings
    • Criar CreateSignaturesRequest
    • Obtenha resultados chamando o método SignApi.create\signatures()

O trecho de código a seguir mostra como pesquisar a assinatura do QR Code e substituí-la por uma assinatura de código de barras em um documento PDF assinado usando uma API REST. Siga as etapas mencionadas anteriormente para baixar o arquivo atualizado.

# inicialização da API
api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)

# caminho do documento assinado código qr
fileInfo = groupdocs_signature_cloud.FileInfo()
fileInfo.file_path = "signed.pdf"

# pesquisar código 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)

# excluir código 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)

# assinar com código de barras
opts = groupdocs_signature_cloud.SignBarcodeOptions()
opts.signature_type = 'Barcode'
opts.text = '123456789012'
opts.barcode_type = 'Code128'
opts.code_text_alignment = 'None'

# definir a posição da assinatura do código de barras em uma página
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)
Pesquise e substitua assinaturas em documento PDF assinado usando Python

Pesquise e substitua assinaturas em documento PDF assinado usando Python

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 atualizar assinaturas em documentos PDF assinados. Você também aprendeu como pesquisar e substituir assinaturas em documentos PDF assinados na nuvem. Este artigo também explicou como carregar programaticamente um arquivo PDF na nuvem e 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