Eliminar firmas de un documento PDF firmado es un requisito común cuando necesitas una copia limpia para su procesamiento posterior o archivado. GroupDocs.Signature Cloud SDK for Node.js proporciona una biblioteca robusta que te permite manipular firmas PDF de forma programática. En este tutorial aprenderás cómo eliminar todas las firmas de un PDF usando Node.js, verás un ejemplo de código completo y explorarás los comandos cURL equivalentes para la API REST.

Eliminar firmas de un documento PDF firmado en Node.JS en 5 pasos

Los siguientes pasos muestran cómo eliminar firmas de un documento PDF firmado usando el GroupDocs.Signature Cloud SDK for Node.js.

  1. Inicializar la configuración con credenciales: Cree un objeto Configuration que contenga su ID de cliente y secreto.
const config = new Configuration({
    clientId: process.env.GROUPDOCS_CLIENT_ID,
    clientSecret: process.env.GROUPDOCS_CLIENT_SECRET
});
  1. Crear cliente API e instancia de Signature API: Utilice la configuración para crear un ApiClient y luego un SignatureApi.
const apiClient = new ApiClient(config);
const signatureApi = new SignatureApi(apiClient);
  1. Definir la información del archivo PDF de origen: Establezca el filePath del PDF que se encuentra en el almacenamiento de GroupDocs.
const fileInfo = new FileInfo();
fileInfo.filePath = "input.pdf";
  1. Preparar solicitud de eliminación con ruta de salida: Cree un DeleteSignaturesRequest, asigne el fileInfo y especifique dónde se debe guardar el resultado.
const deleteRequest = new DeleteSignaturesRequest();
deleteRequest.fileInfo = fileInfo;
deleteRequest.outputPath = "output.pdf";
  1. Ejecutar la solicitud y manejar el resultado: Llamar a deleteSignatures y procesar la respuesta.
try {
    const result = await signatureApi.deleteSignatures(deleteRequest);
    console.log("All signatures removed successfully.");
    console.log("Result file stored at:", result.path);
} catch (err) {
    console.error("Failed to remove signatures:", err);
}

Para obtener más detalles sobre cada clase, consulte la Referencia de API.

Eliminar todas las firmas del PDF - Ejemplo de código completo

El siguiente ejemplo muestra el flujo de trabajo completo para eliminar firmas de un documento PDF firmado.

const { Configuration, ApiClient, SignatureApi, DeleteSignaturesRequest, FileInfo } = require("@groupdocs/signature-cloud");

async function removeSignaturesFromPdf() {
    // Initialize configuration with your GroupDocs credentials
    const config = new Configuration({
        clientId: process.env.GROUPDOCS_CLIENT_ID,
        clientSecret: process.env.GROUPDOCS_CLIENT_SECRET
    });

// Create API client and Signature API instance
    const apiClient = new ApiClient(config);
    const signatureApi = new SignatureApi(apiClient);

// Define source PDF file (must be already uploaded to GroupDocs storage)
    const fileInfo = new FileInfo();
    fileInfo.filePath = "input.pdf"; // path in GroupDocs storage

// Prepare request to delete all signatures and store result as a new file
    const deleteRequest = new DeleteSignaturesRequest();
    deleteRequest.fileInfo = fileInfo;
    deleteRequest.outputPath = "output.pdf"; // resulting file path in storage

try {
        const result = await signatureApi.deleteSignatures(deleteRequest);
        console.log("All signatures removed successfully.");
        console.log("Result file stored at:", result.path);
    } catch (err) {
        console.error("Failed to remove signatures:", err);
    }
}

removeSignaturesFromPdf();

Nota: Este ejemplo de código demuestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar cualquier ruta de archivo y valores de configuración para que coincidan con su entorno real, verifique que todas las dependencias requeridas estén instaladas correctamente y pruebe exhaustivamente en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o póngase en contacto con el equipo de soporte para obtener ayuda.

Eliminar firmas PDF mediante la API REST usando cURL

A continuación se muestran los comandos cURL que realizan la misma operación a través de la API REST de GroupDocs.

  1. Autenticar y obtener un token de acceso
curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. Cargar el PDF de origen a GroupDocs storage
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary @input.pdf
  1. Ejecutar la operación de eliminación de firmas
curl -X POST "https://api.groupdocs.cloud/v2.0/signature/delete" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.pdf" },
           "outputPath": "output.pdf"
         }'
  1. Descargar el PDF resultante
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Para el contrato completo de la API, consulte la Referencia de API.

Preparando el entorno

Instala la biblioteca mediante npm y asegúrate de que tu versión de Node.js cumpla con los requisitos mínimos.

npm install groupdocs-signature-cloud

También puedes descargar el paquete más reciente desde la página de descarga. Asegúrate de tener una cuenta válida de GroupDocs y de haber generado credenciales de cliente.

Qué hace que GroupDocs.Signature Cloud SDK for Node.js sea ideal para la eliminación de firmas PDF

  • Eliminar todos los tipos de firma - Soporta texto, imagen, código de barras, código QR y firmas digitales.
  • Integración con almacenamiento en la nube - Funciona directamente con los archivos almacenados en GroupDocs cloud, eliminando la necesidad de manejar archivos localmente.
  • Alto rendimiento - Optimizado para documentos PDF grandes y procesamiento por lotes.
  • API completa - Los endpoints REST completos se reflejan en la biblioteca Node.js, dándote flexibilidad para elegir código o cURL.
  • Procesamiento seguro - Todas las operaciones se realizan a través de HTTPS y respetan los permisos de tu cuenta.

Para obtener una comprensión más profunda, consulte la documentación oficial.

Opciones de eliminación de firmas de ajuste fino

Mientras que la solicitud básica elimina todas las firmas, puedes ajustar opciones como:

  • outputPath - Elija una carpeta o nombre de archivo diferente para el PDF sin firmar.
  • fileInfo.password - Si el PDF de origen está protegido con contraseña, establezca la contraseña aquí.

Ejemplo de configuración de la ruta de salida (ya mostrada en el fragmento de código anterior):

deleteRequest.outputPath = "output.pdf";

Los parámetros adicionales se enumeran en la referencia de la API.

Mejores prácticas para eliminar firmas de PDFs

  • Validar la existencia del archivo antes de enviar la solicitud para evitar llamadas API innecesarias.
  • Utilizar variables de entorno para las credenciales del cliente y mantenerlas fuera del control de versiones.
  • Almacenar el resultado sin firmar en una carpeta separada para preservar el documento original firmado.
  • Manejar los errores de forma adecuada capturando excepciones y registrando los detalles del error.
  • Probar con diferentes tipos de firma para asegurar que la operación de eliminación funcione en todos los escenarios.

Conclusión

Eliminar firmas de un documento PDF firmado se vuelve sencillo con el GroupDocs.Signature Cloud SDK for Node.js. La biblioteca gestiona la autenticación, el acceso al almacenamiento y la operación de eliminación en solo unas pocas líneas de código, mientras que la API REST ofrece la misma capacidad a través de cURL. Recuerde obtener una licencia adecuada para uso en producción; los detalles de precios están disponibles en la página del producto y puede obtener una licencia temporal en la página de licencia temporal. Con estas herramientas, puede automatizar la eliminación de firmas PDF en cualquier flujo de trabajo de Node.js.

Preguntas frecuentes

  • ¿Cómo funciona la eliminación de firmas de un documento PDF firmado con GroupDocs.Signature Cloud SDK para Node.js?
    La biblioteca se autentica usando su ID de cliente y secreto, luego llama al endpoint DeleteSignatures para eliminar todas las firmas del PDF especificado. Consulte la documentación del GroupDocs.Signature Cloud SDK for Node.js para obtener más detalles.

  • ¿Puedo eliminar firmas de un PDF almacenado en el almacenamiento en la nube de GroupDocs?
    Sí. Proporcione la ruta de almacenamiento en el objeto FileInfo y el SDK accederá al archivo directamente. Consulte la documentación oficial para el manejo del almacenamiento.

  • ¿Qué pasa si necesito conservar una copia del PDF firmado original?
    Especifique un outputPath diferente en DeleteSignaturesRequest para que el archivo original permanezca intacto mientras el nuevo archivo no contenga firmas.

  • ¿Necesito una licencia especial para usar esta funcionalidad en producción?
    Se requiere una licencia válida para su uso en producción. Puede obtener una licencia temporal desde la página de licencia temporal.

Leer más