Ejemplo completo de trabajo para eliminar objetos de anotación de PDF con REST en Node.JS

Este ejemplo muestra cómo subir un PDF, eliminar todas sus anotaciones y descargar el archivo limpio usando el SDK de GroupDocs.Annotation.

const fs = require('fs');
const path = require('path');
const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");

// ==== Authentication =========================================================
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
const annotationsApi = new GroupDocsAnnotationCloud.AnnotationsApi(config);
const storageApi = new GroupDocsAnnotationCloud.StorageApi(config);

// ==== Local & Remote file definitions =======================================
const localInputPath = path.resolve(__dirname, "input.pdf");
const localOutputPath = path.resolve(__dirname, "output.pdf");
const remoteFilePath = "input.pdf";

// ==== Main workflow ==========================================================
(async () => {
    // 1. Upload PDF to GroupDocs Cloud storage
    const fileBytes = fs.readFileSync(localInputPath);
    const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
        path: remoteFilePath,
        file: fileBytes
    });
    await storageApi.uploadFile(uploadRequest);

// 2. Build FileInfo object for the uploaded PDF
    const fileInfo = new GroupDocsAnnotationCloud.FileInfo({
        filePath: remoteFilePath
    });

// 3. Retrieve all existing annotations
    const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
        fileInfo: fileInfo
    });
    const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
    const annotationIds = (annotationsResult.annotations || []).map(a => a.id);

// 4. Delete all annotations (if any)
    if (annotationIds.length > 0) {
        const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
            fileInfo: fileInfo,
            annotationIds: annotationIds
        });
        await annotationsApi.deleteAnnotations(deleteRequest);
    }

// 5. Download the cleaned PDF back to local storage
    const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
        path: remoteFilePath
    });
    const fileStream = await storageApi.downloadFile(downloadRequest);
    fs.writeFileSync(localOutputPath, fileStream);
    console.log(`All annotations removed. Clean file saved to ${localOutputPath}`);
})();

Nota: Este ejemplo de código muestra 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 anotaciones PDF mediante API REST usando cURL

A continuación se presentan los comandos cURL que ejecutan el mismo flujo de eliminación de anotaciones a través de los endpoints REST de GroupDocs.Annotation Cloud.

# 1. Obtain an access token
curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d "{\"client_id\":\"YOUR_CLIENT_ID\",\"client_secret\":\"YOUR_CLIENT_SECRET\"}"

# 2. Upload the source PDF
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"

# 3. Retrieve annotation IDs
curl -X GET "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Delete all retrieved annotations
curl -X DELETE "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d "{\"annotationIds\":[\"id1\",\"id2\"]}"

# 5. Download the cleaned PDF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Para obtener una lista completa de los puntos finales y parámetros, consulte la documentación oficial de la API.

Cómo eliminar objetos de anotación de PDF con REST en Node.JS funciona

1. Configuración de autenticación - La clase Configuration se instancia con su clientId y clientSecret, creando un contexto autenticado para todas las llamadas API posteriores.

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);

2. Carga de archivo - UploadFileRequest envía los bytes del PDF local al almacenamiento de GroupDocs Cloud. El método storageApi.uploadFile maneja la transferencia.

const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
    path: remoteFilePath,
    file: fileBytes
});
await storageApi.uploadFile(uploadRequest);

3. Recuperar anotaciones - GetAnnotationsRequest crea un objeto de solicitud con una referencia FileInfo. La llamada annotationsApi.getAnnotations devuelve una colección de objetos de anotación, de los cuales se extraen los IDs.

const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
    fileInfo: fileInfo
});
const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);

4. Eliminar anotaciones - Si existen IDs, se rellena DeleteAnnotationsRequest y se pasa a annotationsApi.deleteAnnotations, que elimina permanentemente las anotaciones del PDF almacenado.

const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
    fileInfo: fileInfo,
    annotationIds: annotationIds
});
await annotationsApi.deleteAnnotations(deleteRequest);

5. Descargar PDF limpio - Finalmente, DownloadFileRequest recupera el archivo actualizado, y fs.writeFileSync lo escribe en el sistema de archivos local.

const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
    path: remoteFilePath
});
const fileStream = await storageApi.downloadFile(downloadRequest);
fs.writeFileSync(localOutputPath, fileStream);

Para obtener definiciones detalladas de clases y métodos, consulte la referencia de API.

Instalación y Configuración GroupDocs.Annotation Cloud SDK for Node.js

El SDK se distribuye como un paquete npm. Instálalo con el comando a continuación y luego requiérelo en tu proyecto.

npm install groupdocs-annotation-cloud

También puedes descargar el paquete más reciente directamente desde la página de lanzamientos de GitHub o la URL de descarga oficial.

Después de la instalación, importe la biblioteca y cree un objeto de configuración como se muestra en el ejemplo de código:

const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");
const config = new GroupDocsAnnotationCloud.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

Asegúrese de que su entorno de ejecución cumpla con los requisitos de versión de Node.js y de que tenga una cuenta válida de GroupDocs para obtener las credenciales del cliente.

Opciones y Configuraciones para la Eliminación de Anotaciones

El SDK expone varios parámetros que puedes ajustar:

• clientId / clientSecret - Credenciales para la autenticación OAuth. Establécelas en el constructor Configuration.
• fileInfo.filePath - La ruta del PDF en el almacenamiento de GroupDocs Cloud. Ajusta esto si almacenas los archivos en una carpeta diferente.
• annotationIds - Una matriz de IDs devuelta por GetAnnotations. Proporcionar un subconjunto permite la eliminación selectiva.

Configuraciones adicionales, como los tiempos de espera de solicitud y la configuración del proxy, están disponibles en la documentación del SDK; consulte la documentación oficial para obtener la lista completa.

Mejores prácticas para eliminar anotaciones PDF mediante REST

• Validar IDs de anotaciones - Siempre verifique que los IDs que pretende eliminar existan; intentar eliminar IDs que no existen puede provocar un error 404.
• Usar HTTPS - Todas las llamadas a la API deben realizarse mediante HTTPS para proteger sus credenciales y los datos del documento.
• Manejar archivos grandes con cargas fragmentadas - Para PDFs de más de 100 MB, prefiera el endpoint de carga multipart para evitar tiempos de espera.
• Registrar respuestas de la API - Guarde los IDs de solicitud y las respuestas para auditorías y una solución de problemas más sencilla.
• Reutilizar tokens de acceso - Almacene en caché el token OAuth hasta que expire para reducir la sobrecarga de autenticación.

Preguntas comunes

• ¿Cómo me autentico con la API de GroupDocs.Annotation Cloud?
  Obtenga un ID de cliente y un secreto de su cuenta de GroupDocs, luego solicite un token de acceso a través del endpoint OAuth. Consulte la documentación oficial para más detalles.

• ¿Puedo eliminar anotaciones específicas en lugar de todas?
  Sí, proporcione los IDs de las anotaciones que desea eliminar en el DeleteAnnotationsRequest. El SDK devuelve la lista de IDs de anotaciones después de una llamada a GetAnnotations.

• ¿Cómo puedo eliminar objetos de anotación de PDF con REST en Node.JS?
  Utilice el GroupDocs.Annotation Cloud SDK for Node.js para llamar al endpoint DeleteAnnotations después de obtener los IDs de anotación. El flujo completo se muestra en el ejemplo de código y la sección cURL de esta guía.

• ¿Qué licencia se requiere para uso en producción?
  Se necesita una licencia paga para producción. Puede obtener una licencia temporal en la página de licencia temporal mientras evalúa.

Further Reading

• Extraer o eliminar anotaciones de PDF usando la API REST en Node.js
• Texto tachado en un PDF con Node.js y API REST
• Eliminar anotaciones de PDF usando la API REST en Python

Antes de comenzar: Requisitos previos e instalación

Antes de comenzar, asegúrese de tener lo siguiente:

• Node.js 14 o posterior instalado en su máquina de desarrollo.
• Una cuenta activa de GroupDocs Cloud con ID de cliente y secreto de cliente.
• Acceso a los archivos PDF que desea combinar, almacenados en el almacenamiento de GroupDocs Cloud.

Instale el SDK a través de npm y descargue el paquete más reciente:

npm install groupdocs-merger-cloud

También puedes obtener el SDK desde la página oficial de lanzamientos: Descargar SDK. Después de la instalación, estás listo para comenzar a programar.

Guía paso a paso para combinar PDF en Node.JS

Paso 1: Instalar SDK e Importar Clases Necesarias

Primero, importe las clases que necesitará para combinar PDFs.

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

Esta importación le brinda acceso a la API central, objetos de configuración y descriptores de archivo.

Paso 2: Configure sus credenciales de GroupDocs

Cree un objeto de configuración con sus credenciales de cliente.

const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

Proporcionar las credenciales correctas permite que la biblioteca autentique sus solicitudes.

Paso 3: Definir los archivos PDF a combinar

Enumere los documentos PDF que desea combinar. Este paso le prepara para fusionar PDF en Node.JS de manera eficiente.

const filesToMerge = [
    new FileInfo({ filePath: "input1.pdf" }),
    new FileInfo({ filePath: "input2.pdf" })
];

Cada FileInfo apunta a un archivo almacenado en su almacenamiento de GroupDocs Cloud.

Paso 4: Establecer opciones de fusión

Configure la ubicación de salida y adjunte la lista de archivos a la solicitud de fusión.

const mergeOptions = new MergeOptions();
mergeOptions.fileInfos = filesToMerge;
mergeOptions.outputPath = "merged_output.pdf";

Estas configuraciones controlan cómo fusionas PDF en Node.JS y dónde se guardará el resultado.

Paso 5: Ejecutar la operación de fusión

Cree la instancia de la API, llame al método merge y maneje la respuesta.

const mergeApi = new MergeApi(config);

try {
    const result = await mergeApi.mergeDocuments(mergeOptions);
    console.log("Merge completed. Output file stored at:", result.path);
} catch (error) {
    console.error("Error during PDF merge:", error);
}

La llamada asincrónica devuelve la ruta del documento fusionado si la operación tiene éxito.

Ejemplo completo de implementación para combinar PDFs en Node.JS

El siguiente código demuestra el flujo de trabajo completo desde la configuración hasta el manejo de resultados.

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

// Configure the SDK (replace with your actual credentials)
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

async function mergePdfFiles() {
    // Initialize the Merge API
    const mergeApi = new MergeApi(config);

// Define the PDF files to be merged (must exist in GroupDocs Cloud storage)
    const filesToMerge = [
        new FileInfo({ filePath: "input1.pdf" }),
        new FileInfo({ filePath: "input2.pdf" })
    ];

// Set merge options
    const mergeOptions = new MergeOptions();
    mergeOptions.fileInfos = filesToMerge;
    mergeOptions.outputPath = "merged_output.pdf";

try {
        // Perform the merge operation
        const result = await mergeApi.mergeDocuments(mergeOptions);
        console.log("Merge completed. Output file stored at:", result.path);
    } catch (error) {
        console.error("Error during PDF merge:", error);
    }
}

// Execute the merge
mergePdfFiles();

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 correctamente instaladas 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.

Fusionar PDFs mediante API REST usando cURL

Si prefieres un enfoque puramente REST, la misma operación se puede realizar con comandos cURL.

Primero, obtenga un token de acceso:

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET","grant_type":"client_credentials"}'

Cargue los PDFs de origen en su almacenamiento (reemplace YOUR_ACCESS_TOKEN con el token del paso anterior):

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=input1.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/local/path/input1.pdf"

Repita la carga de input2.pdf. Luego solicite la operación de fusión:

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfos": [
               {"filePath":"input1.pdf"},
               {"filePath":"input2.pdf"}
           ],
           "outputPath":"merged_output.pdf"
         }'

Finalmente, descargue el archivo fusionado:

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=merged_output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged_output.pdf

Para obtener una lista completa de los puntos finales y parámetros, consulte la referencia de API.

Configurando opciones de fusión

El SDK expone varias opciones que le permiten afinar el proceso de fusión:

• outputPath - Ruta de destino para el PDF combinado. Ajuste esto para controlar dónde se almacena el resultado.
• fileInfos - Una matriz de objetos FileInfo que definen los PDFs de origen y su orden.

También puede establecer propiedades adicionales como pages para combinar rangos de páginas específicos, o password para PDFs cifrados. Consulte la documentación oficial para obtener la lista completa de campos configurables.

Consideraciones de rendimiento al combinar PDFs

Al combinar archivos PDF grandes o numerosos, tenga en cuenta estos consejos:

• Utilice async/await para evitar bloquear el bucle de eventos, especialmente con documentos grandes.
• Cargas por lotes: cargue los PDFs de origen en paralelo antes de invocar la fusión para reducir la latencia total.
• Procesamiento por transmisión: para PDFs extremadamente grandes, considere almacenar resultados intermedios en almacenamiento en la nube y fusionarlos en fragmentos más pequeños.
• PDFs cifrados: proporcione contraseñas en los objetos FileInfo; procesar archivos cifrados añade sobrecarga, por lo que fusiónelos después del descifrado cuando sea posible.

Aplicar estas prácticas le ayuda a combinar PDF en Node.JS de manera eficiente mientras minimiza el consumo de memoria.

Preguntas que podrías tener

• ¿Cómo fusiono archivos PDF en Node.JS usando GroupDocs?
  Utilice el GroupDocs.Merger Cloud SDK for Node.js para crear una instancia de MergeApi, configure MergeOptions con sus PDFs de origen y llame a mergeDocuments. El ejemplo completo de código en esta guía muestra el proceso.

• ¿Puedo combinar archivos PDF cifrados en Node.JS?
  Sí, el SDK admite la combinación de PDFs cifrados. Proporcione las contraseñas correctas en los objetos FileInfo antes de llamar a mergeDocuments. Consulte la documentación oficial para obtener más detalles.

• ¿Cuáles son las opciones de licencia para GroupDocs.Merger?
  GroupDocs ofrece planes de precios flexibles. Para pruebas, puedes solicitar una licencia temporal para evaluar la biblioteca antes de comprar una suscripción completa.

• ¿Dónde puedo encontrar más ejemplos y soporte?
  Muestras adicionales están disponibles en el repositorio de GitHub. Para obtener ayuda, visite el foro de soporte.

Lecturas adicionales

• Dividir PDF en varios PDF en Node.JS
• Bloquear documentos PDF con contraseñas usando la API REST en Node.js
• Cómo combinar archivos PDF en C# usando la API REST

Añadir marca de agua de imagen a documentos PDF en Java en 5 pasos

1. Inicializar el cliente API: Crear una instancia de ApiClient con su ID de cliente y secreto.

ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
WatermarkApi watermarkApi = new WatermarkApi(apiClient);

Este paso conecta su código Java al servicio GroupDocs.Watermark Cloud. Consulte la referencia de API para obtener más detalles.

2. Especifique el archivo PDF de origen: Construya un objeto FileInfo que apunte al PDF que desea marcar con una marca de agua.

FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("input.pdf");

El archivo debe cargarse en su almacenamiento GroupDocs antes de la solicitud.

3. Configure la marca de agua de imagen: Defina la ruta de la imagen, la opacidad, el factor de escala, la rotación y la alineación.

ImageWatermark imageWatermark = new ImageWatermark();
imageWatermark.setImagePath("watermark.png");
imageWatermark.setOpacity(0.5);
imageWatermark.setScaleFactor(0.3);
imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
imageWatermark.setMargin(new Margin(10, 10, 10, 10));

Ajuste estos valores para lograr la apariencia deseada; la opacidad controla la transparencia, mientras que scaleFactor determina el tamaño relativo a la página.

4. Establecer opciones de marca de agua y ruta de salida: Combine la información del archivo y la marca de agua en un objeto WatermarkOptions.

WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
options.setImageWatermark(imageWatermark);
options.setOutputPath("output.pdf");

El outputPath indica al servicio dónde almacenar el PDF resultante.

5. Ejecutar la solicitud: Construya un AddWatermarkRequest y llame a la API. Maneje respuestas exitosas o de error.

   AddWatermarkRequest request = new AddWatermarkRequest(options);
   try {
       AddWatermarkResponse response = watermarkApi.addWatermark(request);
       System.out.println("Watermark added successfully. Output file: " + response.getPath());
   } catch (Exception e) {
       System.err.println("Error adding watermark: " + e.getMessage());
   }
   

   Después de la ejecución, el PDF con marca de agua está disponible en la ubicación que especificó.

Ejemplo completo de código: agregar marca de agua de imagen a documentos PDF en Java

El siguiente ejemplo demuestra la implementación completa, desde la inicialización del cliente hasta guardar el PDF con marca de agua.

import com.groupdocs.cloud.watermark.api.WatermarkApi;
import com.groupdocs.cloud.watermark.client.ApiClient;
import com.groupdocs.cloud.watermark.model.AddWatermarkRequest;
import com.groupdocs.cloud.watermark.model.AddWatermarkResponse;
import com.groupdocs.cloud.watermark.model.FileInfo;
import com.groupdocs.cloud.watermark.model.ImageWatermark;
import com.groupdocs.cloud.watermark.model.Margin;
import com.groupdocs.cloud.watermark.model.WatermarkOptions;
import com.groupdocs.cloud.watermark.model.enums.HorizontalAlignment;
import com.groupdocs.cloud.watermark.model.enums.VerticalAlignment;

public class AddImageWatermarkExample {
    public static void main(String[] args) {
        // Initialize API client (replace with your actual credentials)
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        WatermarkApi watermarkApi = new WatermarkApi(apiClient);

// Input PDF file information
        FileInfo fileInfo = new FileInfo();
        fileInfo.setFilePath("input.pdf");

// Image watermark configuration
        ImageWatermark imageWatermark = new ImageWatermark();
        imageWatermark.setImagePath("watermark.png");          // Path to watermark image
        imageWatermark.setOpacity(0.5);                        // 50% opacity
        imageWatermark.setScaleFactor(0.3);                    // 30% of page size
        imageWatermark.setRotationAngle(0);                    // No rotation
        imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
        imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
        imageWatermark.setMargin(new Margin(10, 10, 10, 10));  // 10 points margin on all sides

// Watermark options
        WatermarkOptions options = new WatermarkOptions();
        options.setFileInfo(fileInfo);
        options.setImageWatermark(imageWatermark);
        options.setOutputPath("output.pdf"); // Resulting PDF with watermark

// Create request and call API
        AddWatermarkRequest request = new AddWatermarkRequest(options);
        try {
            AddWatermarkResponse response = watermarkApi.addWatermark(request);
            System.out.println("Watermark added successfully. Output file: " + response.getPath());
        } catch (Exception e) {
            System.err.println("Error adding watermark: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Nota: Este ejemplo de código muestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar las rutas de los archivos (input.pdf, watermark.png, output.pdf) para que coincidan con la ubicación real de sus archivos, verifique que todas las dependencias requeridas estén correctamente instaladas 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.

Aplicar marca de agua de imagen a documentos PDF mediante cURL y API REST

A continuación se presentan las llamadas REST que puede usar con cURL para lograr el mismo resultado sin escribir código Java.

1. Obtener un token de acceso

   curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
        -H "Content-Type: application/json" \
        -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'
   

   La respuesta contiene un access_token que se utiliza en llamadas posteriores.

2. Subir el PDF de origen

   curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@/path/to/input.pdf"
   

3. Subir la imagen de marca de agua

   curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=watermark.png" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@/path/to/watermark.png"
   

4. Agregar la marca de agua de imagen

curl -X POST "https://api.groupdocs.cloud/v2.0/watermark/add" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.pdf" },
           "imageWatermark": {
               "imagePath": "watermark.png",
               "opacity": 0.5,
               "scaleFactor": 0.3,
               "horizontalAlignment": "Center",
               "verticalAlignment": "Center",
               "margin": { "top": 10, "right": 10, "bottom": 10, "left": 10 }
           },
           "outputPath": "output.pdf"
         }'

Esta solicitud refleja la lógica del código Java, aplicando los mismos ajustes de opacidad, escala y alineación.

5. Descargar el PDF con marca de agua

   curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.pdf
   

Para obtener más detalles sobre los cuerpos de solicitud y los parámetros admitidos, consulte la documentación oficial de la API.

Instalación y configuración GroupDocs.Watermark Cloud SDK for Java

Agregue la dependencia de Maven a su pom.xml (o el fragmento equivalente de Gradle). La biblioteca está alojada en Maven Central.

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-watermark-cloud</artifactId>
    <version>23.8</version>
</dependency>

También necesita una cuenta válida de GroupDocs Cloud. Obtenga su Client ID y Client Secret del portal de GroupDocs. No se requiere ninguna instalación adicional en tiempo de ejecución porque el SDK se comunica con el servicio en la nube.

Ajuste fino de las opciones de marca de agua de imagen para documentos PDF

El SDK expone varias propiedades que le permiten controlar la apariencia visual de la marca de agua.

Ajustar Opacidad

imageWatermark.setOpacity(0.75); // 75% opacity for a more visible watermark

Los valores de opacidad van de 0.0 (totalmente transparente) a 1.0 (totalmente opaco).

Cambiar factor de escala

imageWatermark.setScaleFactor(0.5); // Watermark occupies 50% of the page width

El factor de escala determina el tamaño de la marca de agua en relación con las dimensiones de la página.

Establecer alineación y márgenes

imageWatermark.setHorizontalAlignment(HorizontalAlignment.RIGHT);
imageWatermark.setVerticalAlignment(VerticalAlignment.BOTTOM);
imageWatermark.setMargin(new Margin(20, 20, 20, 20));

Estas configuraciones colocan la marca de agua en la esquina inferior derecha con un margen de 20 puntos.

Para obtener una lista completa de las propiedades configurables, consulte la referencia de API.

Conclusión

Agregar una marca de agua de imagen a documentos PDF en Java es una tarea sencilla cuando utilizas el GroupDocs.Watermark Cloud SDK for Java. El SDK maneja toda la manipulación de PDF de bajo nivel, permitiéndote centrarte en los aspectos visuales como la opacidad, el escalado y la posición. Ya sea que prefieras una implementación nativa de Java o un flujo de trabajo basado en cURL en la nube, los mismos resultados de alta calidad son alcanzables sin sacrificar el rendimiento. Recuerda obtener una licencia adecuada para uso en producción; los detalles de precios están disponibles en la página del producto y una página de licencia temporal puede usarse para la evaluación.

FAQs

• ¿Cómo agregar una marca de agua de imagen a un PDF en Java sin perder calidad?
  Utilice la propiedad scaleFactor para dimensionar la marca de agua en relación con la página y mantener el DPI original del PDF de origen. El SDK conserva la resolución del PDF, por lo que la marca de agua se muestra nítida en cualquier nivel de zoom.

• ¿Puedo agregar varias marcas de agua al mismo PDF?
  Sí. Crea objetos ImageWatermark separados con diferentes configuraciones y añádelos secuencialmente llamando a addWatermark varias veces o agregándolos a una lista en la solicitud.

• ¿Cuáles son los formatos de imagen compatibles para la marca de agua?
  La API acepta tipos de imagen comunes como PNG, JPG, BMP, GIF y TIFF. Se recomienda PNG para calidad sin pérdidas y soporte de transparencia.

• ¿Hay alguna forma de previsualizar la marca de agua antes de aplicarla?
  Puede usar el GroupDocs.Watermark Cloud SDK for Java para generar un PDF temporal con la marca de agua y descargarlo para revisarlo. Esto utiliza la misma llamada addWatermark con una ruta de salida que apunta a una ubicación temporal.

Read More

• Agregar marca de agua a imágenes usando Java
• Agregar marca de agua a Word en Java - Creador de marcas de agua
• Agregar marca de agua de imagen a PDF | Cómo agregar marca de agua a documentos PDF usando .NET