Rimuovere le firme da un documento PDF firmato è una necessità comune quando è necessario disporre di una copia pulita per ulteriori elaborazioni o archiviazione. GroupDocs.Signature Cloud SDK for Node.js fornisce una libreria robusta che consente di manipolare le firme PDF programmaticamente. In questo tutorial imparerai come eliminare tutte le firme da un PDF usando Node.js, vedrai un esempio di codice completo e esplorerai i comandi cURL equivalenti per l’API REST.

Rimuovere le firme da un documento PDF firmato in Node.JS in 5 passaggi

I seguenti passaggi mostrano come rimuovere le firme da un documento PDF firmato utilizzando il GroupDocs.Signature Cloud SDK for Node.js.

  1. Inizializza la configurazione con le credenziali: Crea un oggetto Configuration che contiene il tuo client ID e il segreto.
const config = new Configuration({
    clientId: process.env.GROUPDOCS_CLIENT_ID,
    clientSecret: process.env.GROUPDOCS_CLIENT_SECRET
});
  1. Crea client API e istanza di Signature API: Usa la configurazione per creare un ApiClient e poi un SignatureApi.
const apiClient = new ApiClient(config);
const signatureApi = new SignatureApi(apiClient);
  1. Definisci le informazioni del file PDF di origine: Imposta il filePath del PDF che si trova nello storage di GroupDocs.
const fileInfo = new FileInfo();
fileInfo.filePath = "input.pdf";
  1. Prepara la richiesta di eliminazione con percorso di output: Crea un DeleteSignaturesRequest, assegna il fileInfo e specifica dove deve essere salvato il risultato.
const deleteRequest = new DeleteSignaturesRequest();
deleteRequest.fileInfo = fileInfo;
deleteRequest.outputPath = "output.pdf";
  1. Esegui la richiesta e gestisci il risultato: Chiama deleteSignatures ed elabora la risposta.
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);
}

Per ulteriori dettagli su ogni classe, consultare il Riferimento API.

Rimuovi tutte le firme dal PDF - Esempio di codice completo

Il seguente esempio dimostra il flusso di lavoro completo per rimuovere le firme da un documento PDF firmato.

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: 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.

Rimuovere le firme PDF tramite API REST usando cURL

Di seguito sono riportati i comandi cURL che eseguono la stessa operazione tramite l’API REST di GroupDocs.

  1. Autenticati e ottieni un token di accesso
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. Carica il PDF di origine su 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. Esegui l’operazione di eliminazione delle firme
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. Scarica il PDF risultante
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Per il contratto API completo, consulta la Riferimento API.

Preparare l’ambiente

Installa la libreria tramite npm e assicurati che la tua versione di Node.js soddisfi i requisiti minimi.

npm install groupdocs-signature-cloud

Puoi anche scaricare l’ultimo pacchetto dalla pagina di download. Assicurati di avere un account GroupDocs valido e di aver generato le credenziali client.

Cosa rende GroupDocs.Signature Cloud SDK for Node.js ideale per la rimozione di firme PDF

  • Elimina tutti i tipi di firma - Supporta firme di testo, immagine, codice a barre, codice QR e firme digitali.
  • Integrazione con storage cloud - Funziona direttamente con i file archiviati nel cloud GroupDocs, eliminando la necessità di gestire file localmente.
  • Prestazioni elevate - Ottimizzato per documenti PDF di grandi dimensioni e elaborazione batch.
  • API completa - Tutti gli endpoint REST sono replicati nella libreria Node.js, offrendoti flessibilità nella scelta tra codice o cURL.
  • Elaborazione sicura - Tutte le operazioni avvengono su HTTPS e rispettano le autorizzazioni del tuo account.

Per approfondire, consultare la documentazione ufficiale.

Opzioni di messa a punto per l’eliminazione della firma

Mentre la richiesta di base rimuove ogni firma, è possibile regolare opzioni come:

  • outputPath - Scegli una cartella o un nome file diverso per il PDF non firmato.
  • fileInfo.password - Se il PDF di origine è protetto da password, imposta la password qui.

Esempio di impostazione del percorso di output (già mostrato nello snippet di codice sopra):

deleteRequest.outputPath = "output.pdf";

I parametri aggiuntivi sono elencati nella documentazione API.

Linee guida per la rimozione delle firme dai PDF

  • Convalidare l’esistenza del file prima di inviare la richiesta per evitare chiamate API non necessarie.
  • Utilizzare le variabili d’ambiente per le credenziali del client per mantenerle fuori dal controllo del codice sorgente.
  • Memorizzare il risultato non firmato in una cartella separata per preservare il documento originale firmato.
  • Gestire gli errori in modo corretto catturando le eccezioni e registrando i dettagli dell’errore.
  • Testare con diversi tipi di firma per garantire che l’operazione di eliminazione funzioni in tutti gli scenari.

Conclusione

Rimuovere le firme da un documento PDF firmato diventa semplice con il GroupDocs.Signature Cloud SDK for Node.js. La libreria gestisce l’autenticazione, l’accesso allo storage e l’operazione di eliminazione in poche righe di codice, mentre l’API REST offre la stessa funzionalità tramite cURL. Ricorda di acquisire una licenza adeguata per l’uso in produzione; i dettagli sui prezzi sono disponibili nella pagina del prodotto e puoi ottenere una licenza temporanea dalla pagina della licenza temporanea. Con questi strumenti, puoi automatizzare la rimozione delle firme PDF in qualsiasi flusso di lavoro Node.js.

FAQs

  • Come funziona la rimozione delle firme da un documento PDF firmato con GroupDocs.Signature Cloud SDK for Node.js?
    La libreria si autentica utilizzando il tuo client ID e secret, quindi chiama l’endpoint DeleteSignatures per rimuovere tutte le firme dal PDF specificato. Consulta la documentazione di GroupDocs.Signature Cloud SDK for Node.js per i dettagli.

  • Posso eliminare le firme da un PDF archiviato nello storage cloud di GroupDocs?
    Sì. Fornisci il percorso di archiviazione nell’oggetto FileInfo e l’SDK accederà direttamente al file. Consulta la documentazione ufficiale per la gestione dello storage.

  • E se avessi bisogno di conservare una copia del PDF originale firmato?
    Specifica un outputPath diverso in DeleteSignaturesRequest in modo che il file originale rimanga intatto mentre il nuovo file non contenga firme.

  • Ho bisogno di una licenza speciale per utilizzare questa funzionalità in produzione?
    È necessaria una licenza valida per l’uso in produzione. È possibile ottenere una licenza temporanea dalla pagina della licenza temporanea.

Read More