Conversão de PDF para DOCX em Node.JS

Mon, 03 Aug 2026 10:51:03 +0000

Converter arquivos PDF para o formato DOCX é uma necessidade frequente ao desenvolver aplicações centradas em documentos, especialmente quando você precisa de saída editável do Word. GroupDocs.Conversion Cloud SDK for Node.js fornece uma API robusta que torna essa tarefa simples e escalável. Neste guia você verá um exemplo completo de código assíncrono, aprenderá como obter o mesmo resultado com chamadas REST via cURL, configurará o SDK e aplicará recomendações de melhores práticas para conversões confiáveis.

Exemplo de Código Completo: Conversão Assíncrona de PDF para DOCX em Node.JS

Este exemplo demonstra como executar uma conversão assíncrona de PDF para DOCX usando o GroupDocs.Conversion Cloud SDK for Node.js.

// PDF to DOCX conversion using GroupDocs.Conversion Cloud SDK for Node.js

const GroupDocsConversionCloud = require('groupdocs-conversion-cloud');
const path = require('path');

// -------------------- Configuration --------------------
const CLIENT_ID = process.env.GROUPDOCS_CLIENT_ID || 'YOUR_CLIENT_ID';
const CLIENT_SECRET = process.env.GROUPDOCS_CLIENT_SECRET || 'YOUR_CLIENT_SECRET';

// Initialize API client
const apiInstance = new GroupDocsConversionCloud.ConversionApi();
apiInstance.apiClient = new GroupDocsConversionCloud.ApiClient();
apiInstance.apiClient.basePath = 'https://api.groupdocs.cloud';
apiInstance.apiClient.authentications['JWT'].clientId = CLIENT_ID;
apiInstance.apiClient.authentications['JWT'].clientSecret = CLIENT_SECRET;

// -------------------- Conversion Logic --------------------
async function convertPdfToDocx() {
    try {
        // Input file information (must already be uploaded to GroupDocs Cloud storage)
        const inputFileInfo = new GroupDocsConversionCloud.FileInfo();
        inputFileInfo.filePath = path.normalize('input.pdf'); // generic path in cloud storage

// DOCX specific conversion options (optional, shown for demonstration)
        const docxOptions = new GroupDocsConversionCloud.DocxConvertOptions();
        docxOptions.preserveOriginalFormatting = true; // keep original PDF layout as much as possible
        docxOptions.password = null; // if PDF is password protected, set it here

// Build conversion request
        const convertRequest = new GroupDocsConversionCloud.ConvertDocumentRequest();
        convertRequest.format = 'docx';
        convertRequest.fileInfo = inputFileInfo;
        convertRequest.outputPath = path.normalize('output.docx'); // result will be stored in cloud storage
        convertRequest.options = docxOptions; // attach format‑specific options

// Perform conversion (async)
        const conversionResult = await apiInstance.convertDocument(convertRequest);

// conversionResult contains the path of the generated file and other metadata
        console.log('Conversion succeeded.');
        console.log('Output file path:', conversionResult.path);
        console.log('File size (bytes):', conversionResult.size);
    } catch (error) {
        // Detailed error handling
        if (error.response && error.response.body) {
            console.error('API error:', error.response.body);
        } else {
            console.error('Unexpected error:', error.message);
        }
    }
}

// -------------------- Execution --------------------
(async () => {
    // Optional: set a timeout to avoid hanging indefinitely
    const timeoutMs = 300000; // 5 minutes
    const timeout = setTimeout(() => {
        console.error('Conversion timed out after', timeoutMs / 1000, 'seconds');
        process.exit(1);
    }, timeoutMs);

await convertPdfToDocx();

clearTimeout(timeout);
    // Graceful shutdown
    process.exit(0);
})();

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar os caminhos dos arquivos (input.pdf, output.docx, etc.) para corresponder aos seus locais reais, verifique se todas as dependências necessárias estão 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.

Converter documentos usando cURL e a API REST

Você pode obter a mesma conversão de PDF para DOCX sem escrever código, chamando diretamente os endpoints REST do GroupDocs.Conversion Cloud. As etapas abaixo mostram como obter um token de acesso, fazer upload de um PDF, iniciar a conversão e baixar o arquivo DOCX resultante.

Autenticar e obter um token de acesso
Substitua YOUR_CLIENT_ID e YOUR_CLIENT_SECRET pelas suas credenciais.

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

A resposta contém access_token que você usará nas chamadas subsequentes.

Carregue o PDF de origem

curl -X PUT "https://api.groupdocs.cloud/v1.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary @./local/input.pdf

Execute a conversão

curl -X POST "https://api.groupdocs.cloud/v1.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "format":"docx",
           "fileInfo":{"filePath":"input.pdf"},
           "outputPath":"output.docx",
           "options":{"preserveOriginalFormatting":true}
         }'

A resposta retorna o caminho do arquivo DOCX gerado.

Baixe o DOCX convertido

curl -X GET "https://api.groupdocs.cloud/v1.0/storage/file/output.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o ./local/output.docx

Para obter mais detalhes sobre os payloads de solicitação e opções adicionais, veja a documentação oficial da API.

Desmembrando a Conversão de PDF para DOCX em Node.JS

Abaixo está um guia conciso das partes principais do exemplo de código assíncrono.

Importar e configurar o cliente

const GroupDocsConversionCloud = require('groupdocs-conversion-cloud');
const apiInstance = new GroupDocsConversionCloud.ConversionApi();

A classe ConversionApi (referência da API) é o ponto de entrada para todas as operações de conversão.

Defina as credenciais de autenticação

apiInstance.apiClient.authentications['JWT'].clientId = CLIENT_ID;
apiInstance.apiClient.authentications['JWT'].clientSecret = CLIENT_SECRET;

A autenticação JWT protege cada solicitação ao serviço em nuvem.

Prepare as informações do arquivo de entrada

const inputFileInfo = new GroupDocsConversionCloud.FileInfo();
inputFileInfo.filePath = path.normalize('input.pdf');

FileInfo informa à API onde o PDF de origem está armazenado no armazenamento do GroupDocs Cloud.

Configure opções específicas de DOCX

const docxOptions = new GroupDocsConversionCloud.DocxConvertOptions();
docxOptions.preserveOriginalFormatting = true;

DocxConvertOptions permite que você mantenha o layout original e manipule senhas, se necessário.

Criar e enviar a solicitação de conversão

const convertRequest = new GroupDocsConversionCloud.ConvertDocumentRequest();
convertRequest.format = 'docx';
convertRequest.fileInfo = inputFileInfo;
convertRequest.outputPath = path.normalize('output.docx');
convertRequest.options = docxOptions;
const conversionResult = await apiInstance.convertDocument(convertRequest);

O método convertDocument realiza a conversão real e retorna metadados, como o caminho de saída e o tamanho do arquivo.

Instalação e Configuração GroupDocs.Conversion Cloud SDK for Node.JS

Instale o pacote

npm install groupdocs-conversion-cloud

O pacote está disponível no registro público npm. Consulte a página de download para detalhes da versão.

Pré-requisitos
- Node.js 12 ou superior.
- Uma conta do GroupDocs Cloud com ID do cliente e segredo do cliente.
Inicialize o SDK no seu projeto (trecho do exemplo completo)

const GroupDocsConversionCloud = require('groupdocs-conversion-cloud');
const apiInstance = new GroupDocsConversionCloud.ConversionApi();
apiInstance.apiClient.basePath = 'https://api.groupdocs.cloud';

Ajuste o basePath se você usar um endpoint regional.

Melhores Práticas para Conversão de Documentos de Alto Desempenho

Reutilize o cliente da API em vez de criar uma nova instância para cada conversão; isso reduz a sobrecarga de autenticação.
Habilite uploads em streaming para PDFs grandes a fim de evitar carregar o arquivo inteiro na memória.
Defina um tempo limite razoável (por exemplo, 5 minutos) para impedir trabalhos travados, permitindo ainda que documentos complexos sejam concluídos.
Preserve a formatação original apenas quando necessário; desativá‑la pode acelerar a conversão de PDFs simples contendo apenas texto.
Monitore os limites de uso da API no painel da sua conta GroupDocs para evitar restrições durante operações em lote.

Conclusão

GroupDocs.Conversion Cloud SDK for Node.js torna a conversão de PDF para DOCX simples, seja você prefira uma biblioteca completa ou chamadas REST diretas com cURL. Seguindo o exemplo de código assíncrono, configurando o cliente corretamente e aplicando as dicas de desempenho acima, você pode integrar a conversão confiável de documentos em qualquer serviço Node.JS. 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 uma licença temporária pode ser obtida na página de licença temporária para avaliação.

FAQs

Como a conversão de PDF para DOCX em Node.JS lida com layouts complexos?
O SDK tenta preservar a formatação original por padrão. Você pode alternar preserveOriginalFormatting em DocxConvertOptions para trocar fidelidade por velocidade. Consulte a referência da API para todas as opções.
Quais são os limites de tamanho de arquivo para a conversão de PDF para DOCX?
O serviço em nuvem aceita arquivos de até 200 MB para contas gratuitas; arquivos maiores requerem um plano atualizado. Os uploads são transmitidos em streaming, portanto o uso de memória no seu servidor permanece baixo.
Posso converter vários PDFs para DOCX em uma única solicitação?
A API processa um documento por solicitação, mas você pode percorrer uma lista de arquivos no Node.JS e executar conversões em paralelo, respeitando os limites de simultaneidade da sua conta.
Existe uma maneira de testar a conversão localmente sem uma licença paga?
Sim, você pode solicitar uma licença de avaliação temporária na página de licença temporária. Isso fornece funcionalidade completa para desenvolvimento e teste.

nodejs conversion on Document Processing REST APIs | GroupDocs Cloud