Instalação

O pacote é disponível em PyPI e pode ser instalado via pip executando o seguinte comando:

pip install groupdocs-signature-cloud

Requisitos

• Python 2.7 ou 3.4+
• pip gerenciador de pacotes
• GroupDocs Credenciais Cloud — Client ID and Client Secret do Dashboard

Dependências

O SDK instala automaticamente os seguintes pacotes:

Python Cloud REST API para assinatura eletrônica de documentos

GroupDocs.Signature Cloud SDK para Python fornece uma solução abrangente para integração de assinaturas eletrônicas em aplicativos da web, scripts e fluxos de trabalho de automação Python. Ele suporta uma ampla variedade de tipos de assinatura – texto, imagem, código de barras, código QR, digital e carimbo – em formatos Word, Excel, PDF, apresentação e imagem. Os desenvolvedores podem personalizar a aparência, o posicionamento e a segurança da assinatura, aplicar certificados digitais, verificar a autenticidade da assinatura e pesquisar assinaturas existentes em documentos. Seja assinando uma única página ou gerenciando várias assinaturas em uma coleção de documentos, o GroupDocs.Signature oferece ferramentas robustas para assinatura segura e eficiente de documentos baseada na nuvem.

Cloud Recursos de assinatura de documentos

Aplicar assinaturas a páginas específicas - Aplique assinaturas em páginas pares, ímpares ou específicas para posicionamento preciso.
Configurar o preenchimento da página - Defina o preenchimento da página para alinhar as assinaturas com precisão em cada página.
Personalizar a aparência da assinatura - Controle fontes, cores e estilo das assinaturas.
Aplicar configurações de corte de fundo - Use configurações de corte de fundo para melhorar a visibilidade da assinatura.
Repetir sequência de assinatura - Repita sequências de assinatura para preencher áreas definidas.
Assinaturas Digitais com CryptoApi e XmlDsig - Suporta assinaturas digitais via CryptoApi e XmlDsig.
Alinhar texto para assinaturas de código de barras - Alinhe assinaturas de código de barras usando texto configurável.
Assine documentos protegidos por senha - Assine documentos protegidos por senha.
Verificar assinaturas de documentos - Verifique a autenticidade e validade das assinaturas de documentos.
Pesquisar tipos de assinatura - Pesquise tipos de assinatura específicos em documentos.

Recursos avançados

Personalizar a aparência da assinatura - Personalize fontes, cores e estilo da assinatura.
Gerenciar múltiplas assinaturas - Lide com múltiplas assinaturas em um documento.
Proteção por senha para documentos - Adicione proteção por senha a documentos assinados.
Verifique a autenticidade da assinatura - Valide a autenticidade das assinaturas aplicadas.
Pesquisar assinaturas específicas - Pesquise texto, código de barras, código QR e assinaturas digitais.
Atualizar e excluir assinaturas - Modifique ou remova assinaturas existentes de documentos.

Assinaturas de código de barras e QR-Code

Formatos suportados para assinaturas de código de barras/QR - Suporta DOC, DOCX, XLSX, PDF e formatos de imagem.
Personalizar assinaturas de código de barras/código QR - Personalize a aparência e o conteúdo de assinaturas de código de barras/QR.
Cenários de uso de código de barras/código QR - Os casos de uso incluem rastreamento e identificação de documentos.

Assinaturas de carimbo

Visão geral das assinaturas de carimbos - Assinaturas de carimbos visuais e de texto para documentos oficiais.
Personalizar assinaturas de carimbo - Ajuste o tamanho, o texto e a aparência do carimbo.

Tipos de assinatura suportados

Assinatura de texto - Adicione rótulos de texto personalizáveis ​​com fonte, cor e alinhamento.
Assinatura de imagem - Aplique assinaturas de imagem com opacidade, escala de cinza, brilho e contraste.
Assinatura de código de barras - Adicione tipos de código de barras com aparência, alinhamento e codificação flexíveis.
Assinatura de QR-Code - Insira assinaturas de QR-Code com codificação e aparência personalizáveis.
Assinatura Digital - Aplique certificados digitais (PFX, CRT) em documentos ou páginas PDF.
Assinatura de carimbo - Coloque imagens de carimbo em páginas com personalização flexível.

Operações de arquivo

Carregar arquivos para Cloud - Carregar arquivos para armazenamento em nuvem por meio do API.
Baixar arquivos de Cloud - Baixe arquivos do armazenamento em nuvem para sistemas locais.
Copiar arquivos - Copie arquivos do armazenamento em nuvem para locais diferentes.
Mover arquivos - Mova arquivos entre pastas no armazenamento em nuvem.
Excluir arquivos - Exclua arquivos específicos do armazenamento em nuvem.

Operações de pasta

Criar pasta - Crie novas pastas no armazenamento em nuvem.
Copiar pasta - Duplique pastas no armazenamento em nuvem.
Mover pasta - Mova pastas entre diretórios no armazenamento em nuvem.
Excluir pasta - Remova pastas inteiras do armazenamento em nuvem.

Licenciamento e Autenticação

Modo de avaliação - Experimente o API com uma conta de teste gratuita.
Autenticação segura – Use o ID do cliente e o segredo do cliente para acesso seguro ao API.
Licença MIT - O Python SDK é licenciado sob MIT License.

Formatos de documentos suportados

GroupDocs.Signature Cloud suporta assinatura nas seguintes categorias de formato:

• Processamento de texto: DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, OTT, RTF, TXT
• Planilhas: XLS, XLSX, XLSB, XLSM, CSV, ODS, OTS, TSV
• Apresentações: PPT, PPTX, PPTM, PPS, PPSX, PPSM, ODP, OTP, POTX, POTM
• PDF: PDF
• Imagens: BMP, GIF, JPEG, PNG, TIFF, SVG, PSD, WEBP, ICO, EMF, WMF e muito mais Os tipos de assinatura suportados variam de acordo com o formato. Para a matriz de formato completa, consulte documentation.

Início rápido

Obtenha suas credenciais API

Para usar GroupDocs.Signature Cloud, cadastre-se em GroupDocs.Cloud Dashboard e obtenha seu ID do cliente e Segredo do cliente.

Inicialize o API

Use o código a seguir para começar a usar GroupDocs.Signature Cloud SDK para Python:

import groupdocs_signature_cloud

# Get your ClientId and ClientSecret at https://dashboard.groupdocs.cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"

# Create API configuration
configuration = groupdocs_signature_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"

# Create instance of the Sign API
sign_api = groupdocs_signature_cloud.SignApi.from_config(configuration)

Assine um documento com uma assinatura de texto

Depois de inicializado, use este exemplo básico para adicionar uma assinatura de texto a um documento do Word:

import groupdocs_signature_cloud

client_id = "YourClientId"
client_secret = "YourClientSecret"

sign_api = groupdocs_signature_cloud.SignApi.from_keys(client_id, client_secret)

file_info = groupdocs_signature_cloud.FileInfo()
file_info.file_path = "signaturedocs/one-page.docx"

opts = groupdocs_signature_cloud.SignTextOptions()
opts.signature_type = "Text"
opts.text = "GroupDocs.Signature Cloud"
opts.left = 100
opts.top = 100
opts.width = 100
opts.height = 100
opts.page = 1

settings = groupdocs_signature_cloud.SignSettings()
settings.options = [opts]
settings.file_info = file_info
settings.save_options = groupdocs_signature_cloud.SaveOptions()
settings.save_options.output_file_path = "signaturedocs/signedTextOne_page.docx"

request = groupdocs_signature_cloud.CreateSignaturesRequest(settings)
response = sign_api.create_signatures(request)

print("Succeeded count: " + str(len(response.succeeded)))

Com este guia de início rápido, você está pronto para começar a assinar documentos usando GroupDocs.Signature Cloud em seus aplicativos Python. Para mais detalhes, visite documentation.

Obtenha formatos de arquivo suportados

Recupere a lista completa de formatos de arquivo suportados disponíveis através da assinatura API.

import groupdocs_signature_cloud

info_api = groupdocs_signature_cloud.InfoApi.from_keys("YourClientId", "YourClientSecret")

result = info_api.get_supported_file_formats()

for fmt in result.formats:
    print(fmt.file_format)

Assinar Documento com Assinatura Digital

Aplique um certificado digital a um documento para assinatura segura e inviolável.

import groupdocs_signature_cloud

sign_api = groupdocs_signature_cloud.SignApi.from_keys("YourClientId", "YourClientSecret")

file_info = groupdocs_signature_cloud.FileInfo()
file_info.file_path = "signaturedocs/one-page.docx"

opts = groupdocs_signature_cloud.SignDigitalOptions()
opts.signature_type = "Digital"
opts.image_file_path = "signaturedocs/signature.jpg"
opts.certificate_file_path = "signaturedocs/temp.pfx"
opts.password = "1234567890"
opts.left = 100
opts.top = 100
opts.width = 200
opts.height = 100
opts.page = 1

settings = groupdocs_signature_cloud.SignSettings()
settings.options = [opts]
settings.file_info = file_info
settings.save_options = groupdocs_signature_cloud.SaveOptions()
settings.save_options.output_file_path = "signaturedocs/signedDigitalOne_page.docx"

request = groupdocs_signature_cloud.CreateSignaturesRequest(settings)
response = sign_api.create_signatures(request)

print("Succeeded count: " + str(len(response.succeeded)))

Pesquise assinaturas de código de barras

Pesquise assinaturas de código de barras em um documento assinado e recupere detalhes de assinatura correspondentes.

import groupdocs_signature_cloud

sign_api = groupdocs_signature_cloud.SignApi.from_keys("YourClientId", "YourClientSecret")

file_info = groupdocs_signature_cloud.FileInfo()
file_info.file_path = "signaturedocs/signedBarcodeOne_page.docx"

opts = groupdocs_signature_cloud.SearchBarcodeOptions()
opts.signature_type = "Barcode"
opts.page = 1

settings = groupdocs_signature_cloud.SearchSettings()
settings.options = [opts]
settings.file_info = file_info

request = groupdocs_signature_cloud.SearchSignaturesRequest(settings)
response = sign_api.search_signatures(request)

print("Signatures found: " + str(len(response.signatures)))

Verifique a assinatura do texto

Verifique se existe uma assinatura de texto com o conteúdo esperado em um documento assinado.

import groupdocs_signature_cloud

sign_api = groupdocs_signature_cloud.SignApi.from_keys("YourClientId", "YourClientSecret")

file_info = groupdocs_signature_cloud.FileInfo()
file_info.file_path = "signaturedocs/signedTextOne_page.docx"

opts = groupdocs_signature_cloud.VerifyTextOptions()
opts.signature_type = "Text"
opts.text = "GroupDocs.Signature Cloud"
opts.match_type = "Contains"
opts.page = 1

settings = groupdocs_signature_cloud.VerifySettings()
settings.options = [opts]
settings.file_info = file_info

request = groupdocs_signature_cloud.VerifySignaturesRequest(settings)
response = sign_api.verify_signatures(request)

print("IsSuccess: " + str(response.is_success))

Assinar documento com assinatura de código de barras

Adicione uma assinatura de código de barras a um documento com aparência e codificação personalizáveis.

import groupdocs_signature_cloud

sign_api = groupdocs_signature_cloud.SignApi.from_keys("YourClientId", "YourClientSecret")

file_info = groupdocs_signature_cloud.FileInfo()
file_info.file_path = "signaturedocs/one-page.docx"

opts = groupdocs_signature_cloud.SignBarcodeOptions()
opts.signature_type = "Barcode"
opts.text = "123456789012"
opts.barcode_type = "Code128"
opts.left = 100
opts.top = 100
opts.width = 300
opts.height = 100
opts.page = 1

settings = groupdocs_signature_cloud.SignSettings()
settings.options = [opts]
settings.file_info = file_info
settings.save_options = groupdocs_signature_cloud.SaveOptions()
settings.save_options.output_file_path = "signaturedocs/signedBarcodeOne_page.docx"

request = groupdocs_signature_cloud.CreateSignaturesRequest(settings)
response = sign_api.create_signatures(request)

print("Succeeded count: " + str(len(response.succeeded)))

Exemplos de projetos em GitHub

O repositório GroupDocs.Signature Cloud Python Samples inclui exemplos prontos para execução que abrangem:

Como executar os exemplos

1. Clone ou baixe o samples repository
2. Edite RunExamples.py e defina seu client_id e client_secret
3. Vá para o diretório Examples
4. Execute pip install groupdocs-signature-cloud -U
5. Execute python RunExamples.py Para mais detalhes, visite Getting Started.

Tags

eSignature API | Python Cloud API | GroupDocs.Signature Cloud | REST API | Digital Signature | Text Signature | Barcode Signature | QR-Code Signature | Document Signing | Signature Verification | Signature Search | Cloud Storage Integration | File Operations | Folder Operations | Secure API Access | PDF Signing | Word Document Signing | Image Signature | Stamp Signature | Cross-platform API | Document Security | Electronic Signature