Esempio completo funzionante per rimuovere gli oggetti di annotazione da PDF con REST in Node.JS

Questo esempio dimostra come caricare un PDF, eliminare tutte le sue annotazioni e scaricare il file pulito utilizzando il GroupDocs.Annotation SDK.

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: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano installate correttamente e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Elimina le annotazioni PDF tramite REST API usando cURL

Di seguito sono riportati i comandi cURL che eseguono lo stesso flusso di rimozione delle annotazioni tramite gli endpoint REST di 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

Per un elenco completo di endpoint e parametri, consulta la documentazione ufficiale dell’API.

Come rimuovere gli oggetti di annotazione da PDF con REST in Node.JS

1. Configurazione dell’autenticazione - La classe Configuration viene istanziata con il tuo clientId e clientSecret, creando un contesto autenticato per tutte le successive chiamate API.

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

2. Caricamento del file - UploadFileRequest invia i byte PDF locali allo storage di GroupDocs Cloud. Il metodo storageApi.uploadFile gestisce il trasferimento.

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

3. Recupero delle annotazioni - GetAnnotationsRequest costruisce un oggetto di richiesta con un riferimento FileInfo. La chiamata annotationsApi.getAnnotations restituisce una collezione di oggetti annotazione, da cui vengono estratti gli ID.

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

4. Eliminazione delle annotazioni - Se esistono ID, DeleteAnnotationsRequest viene popolato e passato a annotationsApi.deleteAnnotations, che rimuove permanentemente le annotazioni dal PDF memorizzato.

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

5. Download del PDF pulito - Infine, DownloadFileRequest recupera il file aggiornato e fs.writeFileSync lo scrive nel filesystem locale.

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

Per le definizioni dettagliate di classi e metodi, fare riferimento al riferimento API.

Installazione e configurazione di GroupDocs.Annotation Cloud SDK for Node.js

L’SDK è distribuito come pacchetto npm. Installalo con il comando riportato di seguito e poi richiedilo nel tuo progetto.

npm install groupdocs-annotation-cloud

Puoi anche scaricare l’ultimo pacchetto direttamente dalla pagina dei rilasci su GitHub o dall’URL di download ufficiale.

Dopo l’installazione, importa la libreria e crea un oggetto di configurazione come mostrato nell’esempio di codice:

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

Assicurati che il tuo ambiente di runtime soddisfi i requisiti della versione di Node.js e che tu abbia un account GroupDocs valido per ottenere le credenziali client.

Opzioni e impostazioni per la rimozione delle annotazioni

L’SDK espone diversi parametri che è possibile regolare:

• clientId / clientSecret - Credenziali per l’autenticazione OAuth. Impostale nel costruttore Configuration.
• fileInfo.filePath - Il percorso del PDF nello storage di GroupDocs Cloud. Modificalo se memorizzi i file in una cartella diversa.
• annotationIds - Un array di ID restituiti da GetAnnotations. Fornire un sottoinsieme consente la cancellazione selettiva.

Impostazioni aggiuntive come i timeout delle richieste e la configurazione del proxy sono disponibili nella documentazione SDK; consulta la documentazione ufficiale per l’elenco completo.

Best Practices per la rimozione delle annotazioni PDF tramite REST

• Convalida gli ID delle annotazioni - Verifica sempre che gli ID che intendi eliminare esistano; tentare di eliminare ID inesistenti può causare un errore 404.
• Usa HTTPS - Tutte le chiamate API devono essere eseguite tramite HTTPS per proteggere le tue credenziali e i dati dei documenti.
• Gestisci file di grandi dimensioni con upload a blocchi - Per i PDF più grandi di 100 MB, preferisci l’endpoint di upload multipart per evitare timeout.
• Registra le risposte API - Memorizza gli ID delle richieste e le risposte per tracce di audit e una più facile risoluzione dei problemi.
• Riutilizza i token di accesso - Memorizza nella cache il token OAuth fino alla scadenza per ridurre il carico di autenticazione.

Domande comuni

• Come posso autenticarmi con l’API GroupDocs.Annotation Cloud?
  Ottieni un client ID e un segreto dal tuo account GroupDocs, quindi richiedi un token di accesso tramite l’endpoint OAuth. Consulta la documentazione ufficiale per i dettagli.

• Posso eliminare annotazioni specifiche invece di tutte?
  Sì, fornisci gli ID delle annotazioni che desideri rimuovere nella DeleteAnnotationsRequest. L’SDK restituisce l’elenco degli ID delle annotazioni dopo una chiamata GetAnnotations.

• Come posso rimuovere gli oggetti Annotation da PDF con REST in Node.JS?
  Utilizza il GroupDocs.Annotation Cloud SDK for Node.js per chiamare l’endpoint DeleteAnnotations dopo aver recuperato gli ID delle annotazioni. Il flusso completo è mostrato nell’esempio di codice e nella sezione cURL di questa guida.

• Quale licenza è necessaria per l’uso in produzione?
  È necessaria una licenza a pagamento per la produzione. È possibile ottenere una licenza temporanea dalla pagina della licenza temporanea durante la valutazione.

Further Reading

• Estrai o rimuovi le annotazioni da PDF usando l’API REST in Node.js
• Testo barrato in un PDF con Node.js e API REST
• Rimuovi le annotazioni da PDF usando l’API REST in Python

Prima di iniziare: Requisiti e installazione

Prima di iniziare, assicurati di avere quanto segue:

• Node.js 14 o versioni successive installato sulla tua macchina di sviluppo.
• Un account GroupDocs Cloud attivo con client ID e client secret.
• Accesso ai file PDF che desideri combinare, archiviati nello storage GroupDocs Cloud.

Installa l’SDK tramite npm e scarica l’ultima versione del pacchetto:

npm install groupdocs-merger-cloud

Puoi anche recuperare l’SDK dalla pagina di rilascio ufficiale: Download SDK. Dopo l’installazione, sei pronto per iniziare a programmare.

Guida passo-passo per unire PDF in Node.JS

Passo 1: Installa SDK e importa le classi necessarie

Per prima cosa, importa le classi di cui avrai bisogno per unire i PDF.

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

Questa importazione ti consente di accedere all’API principale, agli oggetti di configurazione e ai descrittori di file.

Passo 2: Configura le tue credenziali GroupDocs

Crea un oggetto di configurazione con le credenziali del client.

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

Fornire le credenziali corrette consente alla libreria di autenticare le tue richieste.

Passo 3: Definire i file PDF da unire

Elenca i documenti PDF che desideri combinare. Questo passaggio ti prepara per unire PDF in Node.JS in modo efficiente.

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

Ogni FileInfo punta a un file archiviato nel tuo storage GroupDocs Cloud.

Passo 4: Imposta le opzioni di unione

Configura la posizione di output e allega l’elenco dei file alla richiesta di merge.

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

Queste impostazioni controllano come unire PDF in Node.JS e dove verrà salvato il risultato.

Passo 5: Esegui l’operazione di unione

Crea l’istanza dell’API, chiama il metodo merge e gestisci la risposta.

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 chiamata asincrona restituisce il percorso del documento unito se l’operazione ha successo.

Esempio completo di implementazione per l’unione di PDF in Node.JS

Il codice seguente dimostra il flusso di lavoro completo dalla configurazione alla gestione del risultato.

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: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Unire PDF tramite API REST usando cURL

Se preferisci un approccio REST puro, la stessa operazione può essere eseguita con comandi cURL.

Per prima cosa, ottieni un token di accesso:

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"}'

Carica i PDF di origine nel tuo storage (sostituisci YOUR_ACCESS_TOKEN con il token del passaggio precedente):

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"

Ripeti il caricamento per input2.pdf. Quindi richiedi l’operazione di unione:

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"
         }'

Infine, scarica il file unito:

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

Per un elenco completo di endpoint e parametri, consulta il riferimento API.

Configurazione delle opzioni di unione

L’SDK espone diverse opzioni che consentono di perfezionare il processo di unione:

• outputPath - Percorso di destinazione per il PDF unito. Modifica questo per controllare dove viene memorizzato il risultato.
• fileInfos - Un array di oggetti FileInfo che definiscono i PDF di origine e il loro ordine.

È possibile impostare anche proprietà aggiuntive come pages per unire intervalli di pagine specifici, o password per PDF crittografati. Consulta la documentazione ufficiale per l’elenco completo dei campi configurabili.

Considerazioni sulle prestazioni per l’unione di PDF

Quando si uniscono PDF di grandi dimensioni o numerosi, tenete a mente questi consigli:

• Usa async/await per evitare di bloccare il ciclo di eventi, soprattutto per documenti di grandi dimensioni.
• Caricamenti batch: carica i PDF di origine in parallelo prima di avviare l’unione per ridurre la latenza complessiva.
• Elaborazione in streaming: per PDF estremamente grandi, considera di memorizzare i risultati intermedi nello storage cloud e di unirli in blocchi più piccoli.
• PDF crittografati: fornisci le password negli oggetti FileInfo; l’elaborazione di file crittografati aggiunge overhead, quindi uniscili dopo la decrittazione quando possibile.

Applicare queste pratiche ti aiuta a unire PDF in Node.JS in modo efficiente, riducendo al minimo il consumo di memoria.

Domande che potresti avere

• Come posso unire file PDF in Node.JS usando GroupDocs?
  Usa il GroupDocs.Merger Cloud SDK for Node.js per creare un’istanza MergeApi, configurare MergeOptions con i PDF di origine e chiamare mergeDocuments. L’esempio di codice completo in questa guida dimostra il processo.

• Posso unire file PDF crittografati in Node.JS?
  Sì, l’SDK supporta l’unione di PDF crittografati. Fornisci le password corrette negli oggetti FileInfo prima di chiamare mergeDocuments. Consulta la documentazione ufficiale per ulteriori dettagli.

• Quali sono le opzioni di licenza per GroupDocs.Merger?
  GroupDocs offre piani tariffari flessibili. Per i test, è possibile richiedere una licenza temporanea per valutare la libreria prima di acquistare un abbonamento completo.

• Dove posso trovare più esempi e supporto?
  Esempi aggiuntivi sono disponibili nel repository GitHub. Per assistenza, visita il forum di supporto.

Ulteriori letture

• Dividi PDF in più PDF in Node.JS
• Blocca i documenti PDF con password usando REST API in Node.js
• Come unire file PDF in C# usando REST API

Aggiungi filigrana immagine ai documenti PDF in Java in 5 passaggi

1. Inizializzare il client API: Crea un’istanza di ApiClient con il tuo client ID e secret.

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

Questo passaggio collega il tuo codice Java al servizio GroupDocs.Watermark Cloud. Consulta il riferimento API per ulteriori dettagli.

2. Specifica il file PDF di origine: Crea un oggetto FileInfo che punti al PDF a cui desideri aggiungere la filigrana.

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

Il file deve essere caricato nel tuo storage GroupDocs prima della richiesta.

3. Configura il watermark immagine: Definisci il percorso dell’immagine, l’opacità, il fattore di scala, la rotazione e l’allineamento.

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

Regola questi valori per ottenere l’aspetto desiderato; l’opacità controlla la trasparenza, mentre il fattore di scala determina la dimensione rispetto alla pagina.

4. Imposta le opzioni del watermark e il percorso di output: Combina le informazioni del file e il watermark in un oggetto WatermarkOptions.

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

   Il outputPath indica al servizio dove memorizzare il PDF risultante.

5. Esegui la richiesta: Crea un AddWatermarkRequest e chiama l’API. Gestisci le risposte di successo o di errore.

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());
}

Dopo l’esecuzione, il PDF con filigrana è disponibile nella posizione specificata.

Esempio di codice completo: aggiungere filigrana immagine ai documenti PDF in Java

Il seguente esempio dimostra l’implementazione completa dall’inizializzazione del client al salvataggio del PDF con filigrana.

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: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare i percorsi dei file (input.pdf, watermark.png, output.pdf) per corrispondere alle tue effettive posizioni, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Applica filigrana immagine ai documenti PDF tramite cURL e REST API

Di seguito sono riportate le chiamate REST che è possibile utilizzare con cURL per ottenere lo stesso risultato senza scrivere codice Java.

1. Ottieni un token di accesso

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 risposta contiene un access_token utilizzato nelle chiamate successive.

2. Carica il PDF di origine

   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. Carica l’immagine del watermark

   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. Aggiungi il watermark immagine

   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"
            }'
   

   Questa richiesta replica la logica del codice Java, applicando le stesse impostazioni di opacità, scala e allineamento.

5. Scarica il PDF con filigrana

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

Per ulteriori dettagli su corpi della richiesta e parametri supportati, vedere la documentazione ufficiale dell’API.

Installazione e configurazione GroupDocs.Watermark Cloud SDK for Java

Aggiungi la dipendenza Maven al tuo pom.xml (o lo snippet Gradle equivalente). La libreria è ospitata su Maven Central.

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

È necessario anche un account valido di GroupDocs Cloud. Recupera il tuo Client ID e Client Secret dal portale GroupDocs. Non è richiesta alcuna installazione aggiuntiva del runtime perché l’SDK comunica con il servizio cloud.

Ottimizzazione delle opzioni di filigrana immagine per documenti PDF

L’SDK espone diverse proprietà che consentono di controllare l’aspetto visivo della filigrana.

Regola Opacità

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

I valori di opacità vanno da 0.0 (completamente trasparente) a 1.0 (completamente opaco).

Modifica fattore di scala

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

Il fattore di scala determina la dimensione della filigrana rispetto alle dimensioni della pagina.

Imposta allineamento e margini

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

Queste impostazioni posizionano la filigrana nell’angolo inferiore destro con un margine di 20 punti.

Per un elenco completo delle proprietà configurabili, fare riferimento al riferimento API.

Conclusione

Aggiungere una filigrana immagine ai documenti PDF in Java è un compito semplice quando si utilizza il GroupDocs.Watermark Cloud SDK for Java. L’SDK gestisce tutta la manipolazione PDF a basso livello, consentendoti di concentrarti sugli aspetti visivi come opacità, scala e posizionamento. Che tu preferisca un’implementazione Java nativa o un flusso di lavoro basato su cURL nel cloud, gli stessi risultati di alta qualità sono ottenibili senza sacrificare le prestazioni. Ricorda di ottenere una licenza adeguata per l’uso in produzione; i dettagli dei prezzi sono disponibili nella pagina del prodotto e una pagina di licenza temporanea può essere utilizzata per la valutazione.

Domande frequenti

• Come aggiungere una filigrana immagine a un PDF in Java senza perdere qualità?
  Utilizza la proprietà scaleFactor per dimensionare la filigrana rispetto alla pagina e mantenere i DPI originali del PDF di origine. L’SDK conserva la risoluzione del PDF, quindi la filigrana appare nitida a qualsiasi livello di zoom.

• Posso aggiungere più filigrane allo stesso PDF?
  Sì. Crea oggetti ImageWatermark separati con configurazioni diverse e aggiungili in sequenza chiamando addWatermark più volte o aggiungendoli a un elenco nella richiesta.

• Quali sono i formati immagine supportati per il watermark?
  L’API accetta i tipi di immagine comuni come PNG, JPG, BMP, GIF e TIFF. PNG è consigliato per la qualità senza perdita e il supporto della trasparenza.

• È possibile visualizzare l’anteprima del watermark prima di applicarlo?
  È possibile utilizzare il GroupDocs.Watermark Cloud SDK for Java per generare un PDF temporaneo con il watermark e scaricarlo per la revisione. Questo utilizza la stessa chiamata addWatermark con un percorso di output che punta a una posizione temporanea.

Leggi di più

• Aggiungi filigrana alle immagini usando Java
• Aggiungi filigrana a Word in Java - Watermark Creator
• Aggiungi filigrana immagine a PDF | Come aggiungere filigrana ai documenti PDF usando .NET