Instalación

El paquete es available en PyPI y se puede instalar a través de pip ejecutando el siguiente comando:

pip install groupdocs-signature-cloud

Requisitos

• Python 2.7 o 3.4+
• administrador de paquetes pip
• Credenciales de nube de GroupDocs — Client ID and Client Secret desde el tablero

Dependencias

El SDK instala automáticamente los siguientes paquetes:

API REST de Python Cloud para firma electrónica de documentos

GroupDocs.Signature Cloud SDK para Python proporciona una solución integral para integrar firmas electrónicas en aplicaciones web, scripts y flujos de trabajo de automatización de Python. Admite una amplia gama de tipos de firma (texto, imagen, código de barras, código QR, digital y sello) en formatos Word, Excel, PDF, presentación e imagen. Los desarrolladores pueden personalizar la apariencia, ubicación y seguridad de las firmas, aplicar certificados digitales, verificar la autenticidad de las firmas y buscar firmas existentes en los documentos. Ya sea firmando una sola página o administrando múltiples firmas en una colección de documentos, GroupDocs.Signature ofrece herramientas sólidas para una firma de documentos segura y eficiente basada en la nube.

Funciones de firma de documentos en la nube

Aplicar firmas a páginas específicas: aplique firmas en páginas pares, impares o específicas para una ubicación precisa.
Configurar el relleno de página: configure el relleno de página para alinear las firmas con precisión en cada página.
Personalice la apariencia de la firma: controle las fuentes, los colores y el estilo de las firmas.
Aplicar configuración de recorte de fondo: utilice la configuración de recorte de fondo para mejorar la visibilidad de la firma.
Repetir cadena de firma: repita las cadenas de firma para llenar áreas definidas.
Firmas digitales con CryptoApi y XmlDsig: admite firmas digitales a través de CryptoApi y XmlDsig.
Alinear texto para firmas de códigos de barras: alinee las firmas de códigos de barras utilizando texto configurable.
Firmar documentos protegidos con contraseña: firme documentos protegidos con contraseña.
Verificar firmas de documentos: verificar la autenticidad y validez de las firmas de documentos.
Buscar tipos de firma: busque tipos de firma específicos dentro de los documentos.

Funciones avanzadas

Personalizar la apariencia de la firma: personalice las fuentes, los colores y el estilo de la firma.
Administrar múltiples firmas: administre múltiples firmas en un solo documento.
Protección con contraseña para documentos: agregue protección con contraseña a los documentos firmados.
Verificar autenticidad de firma: validar la autenticidad de las firmas aplicadas.
Buscar firmas específicas: busque texto, códigos de barras, códigos QR y firmas digitales.
Actualizar y eliminar firmas: modifica o elimina firmas existentes de los documentos.

Firmas de códigos de barras y códigos QR

Formatos admitidos para códigos de barras/firmas QR: admite formatos DOC, DOCX, XLSX, PDF y de imagen.
Personalizar firmas de códigos de barras/códigos QR: personalice la apariencia y el contenido de los códigos de barras/firmas QR.
Escenarios de uso de códigos de barras/códigos QR: los casos de uso incluyen el seguimiento y la identificación de documentos.

Firmas de sellos

Descripción general de las firmas de sellos: firmas de sellos visuales y de texto para documentos oficiales.
Personalizar firmas de sellos: ajuste el tamaño, el texto y la apariencia del sello.

Tipos de firma admitidos

Firma de texto: agregue etiquetas de texto personalizables con fuente, color y alineación.
Firma de imagen: aplique firmas de imágenes con opacidad, escala de grises, brillo y contraste.
Firma de código de barras: agregue tipos de códigos de barras con apariencia, alineación y codificación flexibles.
Firma de código QR: inserte firmas de códigos QR con codificación y apariencia personalizables.
Firma digital: aplique certificados digitales (PFX, CRT) a documentos o páginas PDF.
Firma de sello: coloque imágenes de sello en páginas con personalización flexible.

Operaciones de archivos

Cargar archivos a la nube: cargue archivos al almacenamiento en la nube a través de la API.
Descargar archivos desde la nube: descargue archivos desde el almacenamiento en la nube a sistemas locales.
Copiar archivos: copie archivos dentro del almacenamiento en la nube a diferentes ubicaciones.
Mover archivos: mueva archivos entre carpetas en el almacenamiento en la nube.
Eliminar archivos: elimina archivos específicos del almacenamiento en la nube.

Operaciones de carpeta

Crear carpeta: crea nuevas carpetas en el almacenamiento en la nube.
Copiar carpeta: carpetas duplicadas dentro del almacenamiento en la nube.
Mover carpeta: mueve carpetas entre directorios en el almacenamiento en la nube.
Eliminar carpeta: elimina carpetas enteras del almacenamiento en la nube.

Licencias y autenticación

Modo de evaluación: prueba la API con una cuenta de prueba gratuita.
Autenticación segura: utilice el ID de cliente y el secreto de cliente para obtener acceso seguro a la API.
Licencia MIT: el SDK para Python tiene la licencia de MIT License.

Formatos de documentos admitidos

GroupDocs.Signature Cloud admite la firma en las siguientes categorías de formato:

• Procesamiento de textos: DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, OTT, RTF, TXT
• Hojas de cálculo: XLS, XLSX, XLSB, XLSM, CSV, ODS, OTS, TSV
• Presentaciones: PPT, PPTX, PPTM, PPS, PPSX, PPSM, ODP, OTP, POTX, POTM -**PDF:**PDF
• Imágenes: BMP, GIF, JPEG, PNG, TIFF, SVG, PSD, WEBP, ICO, EMF, WMF y más

Los tipos de firma admitidos varían según el formato. Para obtener la matriz de formato completa, consulte la documentation.

Inicio rápido

Obtenga sus credenciales API

Para utilizar GroupDocs.Signature Cloud, regístrese en GroupDocs.Cloud Dashboard y obtenga su ID de cliente y su Secreto de cliente.

Inicializar la API

Utilice el siguiente código para comenzar a utilizar 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)

Firmar un documento con una firma de texto

Una vez inicializado, utilice este ejemplo básico para agregar una firma de texto a un documento de 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)))

Con esta guía de inicio rápido, estará listo para comenzar a firmar documentos usando GroupDocs.Signature Cloud en sus aplicaciones Python. Para más detalles, visite el documentation.

Obtenga formatos de archivo compatibles

Obtenga la lista completa de formatos de archivo compatibles disponibles a través de Signature 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)

Firmar documento con firma digital

Aplique un certificado digital a un documento para una firma segura y a prueba de manipulaciones.

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)))

Buscar firmas de códigos de barras

Busque firmas de códigos de barras en un documento firmado y recupere los detalles de las firmas coincidentes.

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)))

Verificar firma de texto

Verifique que exista una firma de texto con el contenido esperado en un documento firmado.

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))

Firmar documento con firma de código de barras

Agregue una firma de código de barras a un documento con apariencia y codificación personalizables.

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)))

Proyectos de muestra en GitHub

El GroupDocs.Signature Cloud Python Samples El repositorio incluye ejemplos listos para ejecutar que cubren:

Cómo ejecutar los ejemplos

1. Clona o descarga el samples repository2. EditarRunExamples.pyy configura tuclient_idyclient_secret3. Ve alExamplesdirectorio
2. correrpip install groupdocs-signature-cloud -U5. Ejecutarpython RunExamples.py

Para más detalles, visite Getting Started.

Etiquetas

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