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

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

3. 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";

4. 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";

5. 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"

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

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

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

• Como assinar digitalmente um documento Word online
• Remover assinaturas de documento PDF assinado usando Python
• Editar assinaturas em documentos PDF assinados usando Python