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
SubstituaYOUR_CLIENT_IDeYOUR_CLIENT_SECRETpelas 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 alternarpreserveOriginalFormattingemDocxConvertOptionspara 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.