Remover assinaturas de um documento PDF assinado é uma necessidade comum quando você precisa de uma cópia limpa para processamento adicional ou arquivamento. GroupDocs.Signature Cloud SDK for Node.js fornece uma biblioteca robusta que permite manipular assinaturas de PDF programaticamente. Neste tutorial, você aprenderá como excluir todas as assinaturas de um PDF usando Node.js, verá um exemplo de código completo e explorará comandos cURL equivalentes para a API REST.

Remover Assinaturas de Documento PDF Assinado em Node.JS em 5 Etapas

As etapas a seguir mostram como remover assinaturas de um documento PDF assinado usando o GroupDocs.Signature Cloud SDK for Node.js.

  1. Inicializar a configuração com credenciais: Crie um objeto Configuration que contém seu ID de cliente e segredo.
const config = new Configuration({
    clientId: process.env.GROUPDOCS_CLIENT_ID,
    clientSecret: process.env.GROUPDOCS_CLIENT_SECRET
});
  1. Criar cliente API e instância da Signature API: Use a configuração para criar um ApiClient e, em seguida, um SignatureApi.
const apiClient = new ApiClient(config);
const signatureApi = new SignatureApi(apiClient);
  1. Defina as informações do arquivo PDF de origem: Defina o filePath do PDF que está armazenado no GroupDocs storage.
const fileInfo = new FileInfo();
fileInfo.filePath = "input.pdf";
  1. Prepare a solicitação de exclusão com caminho de saída: Crie um DeleteSignaturesRequest, atribua o fileInfo e especifique onde o resultado deve ser salvo.
const deleteRequest = new DeleteSignaturesRequest();
deleteRequest.fileInfo = fileInfo;
deleteRequest.outputPath = "output.pdf";
  1. Execute a solicitação e trate o resultado: Chame deleteSignatures e processe a resposta.
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 obter mais detalhes sobre cada classe, consulte a Referência da API.

Remover Todas as Assinaturas de PDF - Exemplo de Código Completo

O exemplo a seguir demonstra o fluxo de trabalho completo para remover assinaturas de um documento PDF assinado.

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 exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivo e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Remover assinaturas PDF via API REST usando cURL

Abaixo estão os comandos cURL que executam a mesma operação através da API REST do GroupDocs.

  1. Autenticar e obter um token de acesso
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. Carregue o PDF de origem no armazenamento do GroupDocs
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. Execute a operação de exclusão de assinaturas
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. Baixe o 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 o contrato completo da API, veja a Referência da API.

Preparando o Ambiente

Instale a biblioteca via npm e certifique‑se de que sua versão do Node.js atenda aos requisitos mínimos.

npm install groupdocs-signature-cloud

Você também pode baixar o pacote mais recente na página de download. Certifique‑se de que possui uma conta válida do GroupDocs e gerou credenciais de cliente.

O que torna o GroupDocs.Signature Cloud SDK for Node.js ideal para remoção de assinatura em PDF

  • Excluir todos os tipos de assinatura - Suporta texto, imagem, código de barras, QR code e assinaturas digitais.
  • Integração com armazenamento em nuvem - Funciona diretamente com arquivos armazenados no GroupDocs cloud, eliminando a necessidade de manipulação local de arquivos.
  • Alto desempenho - Otimizado para documentos PDF grandes e processamento em lote.
  • API abrangente - Todos os endpoints REST são espelhados na biblioteca Node.js, oferecendo flexibilidade para escolher código ou cURL.
  • Processamento seguro - Todas as operações ocorrem via HTTPS e respeitam as permissões da sua conta.

Para obter mais detalhes, consulte a documentação oficial.

Opções de Exclusão de Assinatura com Ajuste Fino

Embora a solicitação básica remova todas as assinaturas, você pode ajustar opções como:

  • outputPath - Escolha uma pasta ou nome de arquivo diferente para o PDF não assinado.
  • fileInfo.password - Se o PDF de origem estiver protegido por senha, defina a senha aqui.

Exemplo de definição do caminho de saída (já mostrado no trecho de código acima):

deleteRequest.outputPath = "output.pdf";

Parâmetros adicionais estão listados na referência da API.

Melhores Práticas para Remover Assinaturas de PDFs

  • Validar a existência do arquivo antes de enviar a solicitação para evitar chamadas de API desnecessárias.
  • Usar variáveis de ambiente para credenciais do cliente, mantendo-as fora do controle de versão.
  • Armazenar o resultado não assinado em uma pasta separada para preservar o documento original assinado.
  • Tratar erros de forma elegante capturando exceções e registrando os detalhes do erro.
  • Testar com diferentes tipos de assinatura para garantir que a operação de exclusão funcione em todos os cenários.

Conclusão

Remover assinaturas de um documento PDF assinado torna‑se simples com o GroupDocs.Signature Cloud SDK for Node.js. A biblioteca lida com autenticação, acesso ao armazenamento e a operação de exclusão em apenas algumas linhas de código, enquanto a API REST oferece a mesma capacidade via cURL. Lembre‑se de adquirir uma licença adequada para uso em produção; detalhes de preços estão disponíveis na página do produto e você pode obter uma licença temporária na página de licença temporária. Com essas ferramentas, você pode automatizar a remoção de assinaturas de PDF em qualquer fluxo de trabalho Node.js.

FAQs

  • Como a remoção de assinaturas de um documento PDF assinado funciona com GroupDocs.Signature Cloud SDK for Node.js?
    A biblioteca autentica usando seu ID de cliente e segredo, então chama o endpoint DeleteSignatures para remover todas as assinaturas do PDF especificado. Consulte a documentação do GroupDocs.Signature Cloud SDK for Node.js para obter detalhes.

  • Posso excluir assinaturas de um PDF armazenado no GroupDocs cloud storage?
    Sim. Forneça o caminho de armazenamento no objeto FileInfo e o SDK acessará o arquivo diretamente. Consulte a documentação oficial para o gerenciamento de armazenamento.

  • E se eu precisar manter uma cópia do PDF assinado original?
    Especifique um outputPath diferente em DeleteSignaturesRequest para que o arquivo original permaneça intacto enquanto o novo arquivo não contenha assinaturas.

  • Preciso de uma licença especial para usar esta funcionalidade em produção?
    Uma licença válida é necessária para uso em produção. Você pode obter uma licença temporária na página de licença temporária.

Leia Mais