Pular para o conteúdo principal

API de Compressão de Imagens: Teste passo a passo no Postman para JPGs menores

· 11 min para ler
SEO and Content Writer

Imagens pesadas tornam as páginas lentas, aumentam os custos de banda larga e prejudicam o desempenho. Principais indicadores da Web: especialmente Maior Conteúdo de Pintura (LCP) quando uma foto grande é o elemento principal. API de compressão de imagens Permite reduzir o tamanho dos arquivos JPG/PNG no pipeline (manipuladores de upload, importações de CMS, fluxos de trabalho de DAM) em vez de corrigir os arquivos manualmente.

Este guia passo a passo utiliza PDF4me POST /api/v2/CompressImage com CarteiroO mesmo padrão funciona no código assim que o formato da requisição estiver claro. Para um primeiro teste sem código, use o recurso interativo Testador de API de compressão de imagemEle acessa o mesmo endpoint com campos de formulário em vez de JSON bruto.

Como ler este guia
  • Siga os passos 1 → 5As capturas de tela correspondem a uma execução real (seus tempos e contagens de bytes podem variar de acordo com o conteúdo da imagem e a rede).
  • Substitua o espaço reservado para o carteiro. {{BASE64_OF_INPUT_IMAGE}} com o Base64 de seu arquivo, não dados:imagem/jpeg;base64, prefixo na string JSON.
  • Após uma chamada bem-sucedida, decodifique a resposta para um .jpg e comparar tamanho do arquivo no Explorador (ou macOS Finder) para o original.
A versão curta

1. Codifique sua imagem em Base64 → 2. PUBLICAR https://api.pdf4me.com/api/v2/CompressImage com Tipo de conteúdo: application/json e Autorização (sua chave de API do PDF4me) → 3. Corpo JSON: conteúdo do documento, nomeDoDocumento, tipo de imagem, nível de compressão, assíncrono4. Esperar 200 OK e uma carga útil JPEG (bytes brutos ou Base64, dependendo de como seu cliente a exibe) → 5. Salve e compare o tamanho do disco com o arquivo de origem.

Por que as equipes usam uma API de compressão de imagens (contexto de mercado)

PrioridadeO que muda com uma API?
Desempenho da WebImagens menores são decodificadas e transferidas mais rapidamente, o que é importante quando o LCP depende de um único recurso grande.
Experiência do usuárioAs páginas carregam de forma confiável em dispositivos móveis quando as imagens são mais leves, reduzindo o tempo de interação.
OperaçõesUm único contrato HTTP para microsserviços, manipuladores de upload sem servidor e tarefas ETL, sem ferramentas de desktop envolvidas.
CustoMenos saídas e armazenamento em comparação com a disponibilização de arquivos originais de vários MB em todos os lugares.

PDF4me expõe níveis de compressão (Máximo, Médio, Baixo) para que você possa alinhar com miniaturas em vez de imagens principais. Veja a visão geral dos parâmetros em Comprimir imagem (referência completa da API) e a tabela rápida abaixo.

Antes de enviar a primeira solicitação

Lista de verificação
  1. Chave da API: do Painel de controle do PDF4me (usado em Autorização cabeçalho por documentos oficiais).
  2. Formato de entrada: JPG ou PNG (ver Testes de API (notas de parâmetros).
  3. Arquivos grandes / tempos limite: definir "assíncrono": verdadeiro quando recomendado, ou pré-processe com Redimensionar imagem se os pixels excederem em muito o tamanho da tela.
  4. Contingente: Se a autenticação falhar ou os limites do plano forem atingidos, use Solução de problemas do PDF4me Se você vir erros do tipo 401/402.

Referência: Campos do corpo JSON

CampoPapel
conteúdo do documentoVersão Base64 da imagem de origem (obrigatória).
nomeDoDocumentoNome do arquivo de saída, por exemplo: saída.jpg (obrigatório).
tipo de imagemFormato de saída, por exemplo: JPG ou PNG.
nível de compressãoMáximo, Médio, ou Baixo.
assíncronoverdadeiro / falsoUse o modo assíncrono quando o tempo de processamento puder exceder os tempos limite do cliente.

Passo 1: Comece com um arquivo "antes" real.

Use qualquer arquivo JPG grande para praticar. O exemplo de referência abaixo usou um ~4,5 MB arquivo de origem chamado entrada.jpg No Explorador de Arquivos do Windows, o tamanho deve ser suficiente para que a compressão seja visivelmente significativa nas propriedades da pasta.

O Explorador de Arquivos do Windows exibe um arquivo JPG de entrada grande (aproximadamente 4,48 MB) antes de chamar a API de compressão.

Passo 2: Configure a solicitação do Postman (método + URL)

Abra o Cabeçalhos guia. No mínimo, você precisa de Content-Type: application/json e sua chave PDF4me em Authorization (Substitua o marcador da captura de tela pela sua chave real).

Aba Cabeçalhos do Postman para Comprimir Imagem: URL POST e Autorização

Etapa 3: Defina o corpo JSON bruto

Escolher Corpo → bruto → JSONEm seguida, cole uma carga útil com o seguinte formato (substitua pela sua string Base64).

Aba Corpo do Postman com docContent, docName, imageType, compressionLevel e async

{
"docContent": "PASTE_BASE64_HERE_NO_DATA_URL_PREFIX",
"docName": "output.jpg",
"imageType": "JPG",
"compressionLevel": "Max",
"async": false
}
Opcional: Faça algumas verificações básicas antes de clicar em Enviar.
  • JPEG Base64 geralmente começa com /9j/ Quando a ferramenta exibe o formato de string, isso corresponde à assinatura do arquivo JPEG.
  • Se o Postman estiver lento, a solicitação ainda pode ser bem-sucedida; fique atento. 200 OK e salve a saída; considere assíncrono: verdadeiro para trabalhos em lote de produção.
  • Para um formulário guiado em vez de JSON, abra Comprimir imagem no testador de API e comparar os mesmos campos lado a lado.

Passo 4: Envie e leia a resposta

Quando o cliente exibe Base64

Se o Corpo O visualizador está configurado para Base64 e você vê uma longa fila começando com /9j/A carga útil consiste em dados JPEG codificados para exibição. Decodifique-os para um arquivo e abra-o em um visualizador de imagens para confirmar a qualidade.

Postman 200 OK com o corpo da resposta interpretado como JPEG Base64

Quando o cliente exibe binário bruto

Algumas visualizações renderizam cru bytes (metadados como XMP podem aparecer como texto legível dentro do fluxo). A 200 OK significa que a imagem comprimida foi retornada, salve o corpo como saída.jpg utilizando a opção “Salvar resposta” do seu cliente.

Postman 200 OK com corpo de resposta bruto (binário/metadados visíveis)

Etapa 5: Compare o tamanho do arquivo "após" no disco.

Após gravar a resposta no disco, verifique Propriedades Novamente. Na execução de referência, o arquivo compactado pousou próximo a ~2,6 MB: uma redução útil em uma foto de vários megabytes, mantendo o fluxo de trabalho simples. Sua proporção depende do conteúdo, das dimensões e nível de compressão; tentar Médio ou Baixo se Máximo É agressivo demais para fotos de produtos.

O Explorador de Arquivos do Windows exibe o tamanho do arquivo output.jpg compactado após a chamada da API.

Solução de problemas (rápida)

401 / erros de autenticação

Confirme a chave em Autorização e que a chave está ativa. Veja Documentação da API e solução de problemas.

Tempo limite excedido ou chamadas muito lentas

Tentar "assíncrono": verdadeiro onde for compatível, ou reduza primeiro as dimensões em pixels com Redimensionar imagem.

Saída “corrompida” ou vazia

Tira dados:imagem/...;base64, prefixos de conteúdo do documentoRemova as quebras de linha na string Base64 e verifique se o arquivo de origem abre localmente.

Automatize sem o Postman

Leituras relacionadas

Resumo: Um API de compressão de imagens Pertence ao mesmo conjunto de ferramentas que imagens responsivas e cache de CDN: reduz o tamanho dos bytes na origem, tornando cada etapa subsequente mais barata e rápida. Comece com o Testador de APIReproduza a solicitação no Postman seguindo os passos acima e, em seguida, incorpore o JSON ao seu serviço ou módulo de automação quando estiver pronto para publicação.