Pular para o conteúdo principal
API PDF4meIntegraçõesBase de conhecimentoExtensõesTestador de APIBlog

Otimizar Documento - Otimização de Documentos API

PDF4me Otimizar documento Permite otimizar documentos do Word em termos de tamanho e desempenho com três níveis diferentes de compressão e técnicas abrangentes de otimização. API O serviço processa arquivos do Word, reduzindo seu tamanho, comprimindo imagens, limpando o conteúdo, normalizando a formatação e removendo informações pessoais. API recebe conteúdo de documento Word através de REST API chamadas, utilizando Base64 Codificação para transmissão segura. Com suporte para níveis de otimização Baixo, Médio e Alto, que permitem redução de 0 a 90% no tamanho dos arquivos, esta solução é ideal para fluxos de trabalho de preparação de documentos, otimização de armazenamento e melhoria de desempenho.

Artigos relacionados no blogue
Ainda não há nenhuma publicação no blogue sobre esta funcionalidade — em breve.
Entretanto, explore o blogue da PDF4me para encontrar tutoriais e fluxos de trabalho para todas as plataformas.
Visite o blogue →

Autenticando seu API Solicitar​

Para acessar o PDF4me REST APIPara que uma solicitação seja aceita, é necessário incluir as credenciais de autenticação adequadas. A autenticação garante a segurança da comunicação e valida sua identidade como usuário autorizado do sistema. REST API.

Get your api Key

Principais características​

  • Otimização máximaPerfil de compressão máxima para máxima redução do tamanho do arquivo
  • Redução do tamanho do arquivoObtenha uma redução de 80 a 90% no tamanho dos arquivos com a otimização máxima.
  • Compressão de ImagensOtimização inteligente de imagens com preservação da qualidade.
  • Limpeza de conteúdoRemover macros não utilizadas, comentários e conteúdo oculto.
  • Normalização de formataçãoLimpar formatação redundante e estilos não utilizados
  • Remoção de informações pessoaisRemover informações sobre autor, gerente e empresa
  • Otimização de fontesNormalizar fontes e remover propriedades de fonte desnecessárias.
  • Melhoria de compatibilidadeOtimizar documentos para compatibilidade com o Word 2016

REST API Ponto final​

O PDF4me REST API usa padrão HTTP Métodos para interagir com recursos. Todas as operações de otimização de documentos são realizadas por meio de um único ponto de extremidade:

  • Método: POST
  • Ponto final: office/ApiV2Word/OptimizeDocument

REST API Parâmetros​

Lista completa de parâmetros para a função Otimizar Documento REST APIOs parâmetros estão organizados por categoria para melhor compreensão e implementação.

Importante: Os parâmetros marcados com um asterisco (*) são obrigatórios. O nível de otimização determina a agressividade das técnicas de otimização aplicadas.

Parâmetros obrigatórios​

ParâmetroTipoDescriçãoExemplo
documento*ObjectReferência do documento. Deve conter Nome (string): Nome do arquivo Word com extensão .docx{ "Name": "document.docx" }
conteúdo do documento*Base64Conteúdo do documento Word codificado em Base64O documento original não foi modificado - uma nova versão otimizada foi criada.UEsDBBQABgAIAAAA...

Parâmetros opcionais​

ParâmetroTipoDescriçãoExemplo
nível de otimizaçãoStringNível de otimização (ex.: Baixo, Médio, Máximo). Máximo - Compressão máxima (~80-90%). Controla a agressividade das técnicas de otimização."Max"
Versão em WordStringVersão do Word de destino para compatibilidadenull
nome_da_culturaStringCódigo de cultura para processamento de documentos (por exemplo, "en-US", "de-DE", "fr-FR")en-US

Perfil de Otimização​

O Máximo O perfil de otimização proporciona compressão máxima:

  • Redução do tamanho do arquivo80-90%
  • Qualidade da imagemOtimizado para tamanho
  • FormataçãoLimpeza agressiva
  • Comentários: Removido
  • Revisões: Removido
  • Informações pessoais: Removido
  • Macros: Removido
  • Estilos não utilizados: Removido
  • Conteúdo oculto: Removido

Saída​

O PDF4me Otimizar documento REST API Retorna respostas diferentes dependendo do modo de processamento. API retorna o documento Word como um Base64string codificada em JSON formato, não como dados binários.

Processamento síncrono (padrão)

O API processa a solicitação e retorna:

Código de status: 200 OK

Tipo de conteúdo: application/json

Corpo da resposta:

{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "document.docx",
"success": true,
"errorMessage": null
}

Campos de resposta:

  • documento (string): O documento Word otimizado com tamanho de arquivo reduzido, codificado como Base64 corda
  • nome_do_arquivo (string): O nome do arquivo Word de saída
  • sucesso (booleano): Indica se a solicitação foi bem-sucedida.
  • mensagem de erro (string ou nulo): Detalhes do erro quando o sucesso for falso

Como usar:

  1. Extraia o document campo do JSON resposta (Base64)
  2. Decifre o Base64 string para obter os dados binários do documento Word
  3. Salve ou processe o arquivo do Word conforme necessário.

Exemplo (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
const wordBytes = atob(data.document); // Decode Base64
// Save or process wordBytes

Exemplo de solicitação​

Cabeçalho​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Observação:

  • Adquira o seu API chave do PDF4me Painel
  • O API a chave deve ser Base64 codificado e prefixado com "Básico" no Authorization cabeçalho
  • Exemplo: Se o seu API chave é abc123, codifique-o para Base64 e usar Authorization: Basic YWJjMTIz

Carga útil​

Exemplo básico (otimização máxima padrão):

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "optimizationLevel": "Max"
}

Exemplo avançado (com campos opcionais):

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "optimizationLevel": "Max",
 "wordVersion": null,
 "cultureName": "en-US"
}

Exemplos de código​

O PDF4me Otimizar documento REST API Fornece exemplos de código em várias linguagens de programação. Escolha a linguagem que melhor se adapta ao seu ambiente de desenvolvimento:

C# (CSharp) Amostra

Completo C# Implementação para otimização de documentos do Word:

Casos de uso e aplicações industriais​

Casos de uso de serviços jurídicos e profissionais

  • Distribuição de DocumentosOtimizar documentos jurídicos para distribuição ao cliente.
  • Arquivamento públicoPreparar documentos para apresentação em tribunais públicos
  • Armazenamento de ArquivosOtimizar documentos jurídicos para armazenamento a longo prazo
  • Documentos de ConformidadeLimpar documentos para submissão a órgãos reguladores

Obtenha ajuda​

Get Your API KeyAPI SamplesGetting Started