Resize PDF API & SDK Feature

API e SDK para Redimensionar PDF

Controlo Programático das Dimensões do Documento

Controlo Poderoso das Dimensões de Documento nas Suas Mãos

A API de Redimensionamento de PDF proporciona aos programadores controlo preciso sobre as dimensões dos documentos, permitindo ajustes exatos para satisfazer requisitos de saída específicos. Construída para equipas de desenvolvimento que precisam de capacidades robustas de redimensionamento nos seus fluxos de trabalho ou sistemas de gestão de documentos, a API mantém a clareza visual e a integridade de formatação enquanto oferece controlo granular sobre dimensões, margens e seleção de páginas.

Se estiver a criar pipelines de processamento de documentos, plataformas de publicação ou soluções empresariais, a nossa API oferece uma base técnica sólida para implementar redimensionamento de PDFs com mínimo esforço de código.

Ao contrário de bibliotecas genéricas que exigem configuração extensa ou soluções cloud com opções limitadas, a nossa API dedicada fornece uma solução focada e de alto desempenho para manipulação de dimensões com resultados previsíveis em todos os tipos de documento.

Funcionalidades Técnicas e Capacidades

Controlo de Dimensões de Alta Precisão

Defina as dimensões exatas do documento com precisão decimal de 0,1 a 200 polegadas tanto para a largura como para a altura. A API assume por defeito as dimensões padrão A4 (8,3 × 11,7 polegadas), mas aceita valores personalizados para acomodar qualquer requisito de saída. Esta flexibilidade permite redimensionar documentos para corresponder a requisitos específicos de impressoras, formatos de exibição digital ou modelos de documentos padronizados.

width: number($float)
The width in inches. Value range: 0.1-200 inches. Default: 8.3 inches

height: number($float)
The height in inches. Value range: 0.1-200 inches. Default: 11.7 inches

Processamento Seletivo de Páginas

Processe páginas específicas em documentos de várias páginas, definindo intervalos de páginas exatos e páginas individuais. A API suporta números de página separados por vírgulas e intervalos com hífen (por exemplo, "1,3,5-7"), dando-lhe um controlo preciso sobre quais as páginas a redimensionar. Esta abordagem direcionada é particularmente valiosa ao trabalhar com documentos em que apenas certas secções exigem ajustes de dimensão.

pages: string
Format examples:"1,3,5"or"1-3,7"or"1,3-5,7-9"

Pages appear in ascending order in the output regardless of input order

Suporte a PDFs Protegidos por Palavra‑Passe

Processe PDFs protegidos de forma transparente, fornecendo a palavra-passe do documento como parâmetro. Esta funcionalidade elimina interrupções no fluxo de trabalho ao lidar com documentos protegidos e mantém os protocolos de segurança em todo o processo. A API lida com a autenticação de forma transparente, permitindo que a sua aplicação mantenha o processamento contínuo de documentos.

password: string
The password to open the protected PDF file

Arquitetura de Processamento Assíncrono

A API implementa um modelo de processamento assíncrono, retornando um ID de operação imediatamente enquanto o processamento continua em segundo plano. Esta arquitetura evita operações de bloqueio e permite o manuseamento eficiente de documentos maiores. Monitorize o estado da operação através do ponto final /operation/v1/{operationId}/status para determinar quando o processamento está concluído.

{
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Gestão Personalizada de Margens

Defina margens não uniformes para criar documentos com requisitos de layout específicos. Defina medições diferentes para as margens superior, inferior, esquerda e direita de forma independente, acomodando formatos de documentos especializados ou requisitos de impressão. Este controlo granular permite uma formatação precisa de documentos que cumpre as especificações exatas para um resultado profissional.

Por exemplo, pode criar documentos com:

Espaço extra para encadernação na margem esquerda

Margens equilibradas para conteúdo centrado

Margens mínimas para a área máxima de conteúdo

Espaço personalizado para cabeçalho/rodapé com margens superior/inferior expandidas

O mecanismo de processamento em lote mantém desempenho consistente, independentemente da quantidade de arquivos de entrada, com uso de memória previsível que escala linearmente com a complexidade do documento.

Preservação da Integridade do Documento

A API mantém a fidelidade visual durante as operações de redimensionamento, preservando a clareza do texto, a qualidade da imagem e a precisão dos gráficos vetoriais. Esta abordagem técnica garante que os documentos redimensionados permaneçam profissionais e legíveis, independentemente das alterações de dimensão aplicadas. A renderização de fontes, a resolução de imagens e o posicionamento de elementos são todos cuidadosamente preservados durante o processo de transformação.

Guia de Implementação

Integração via API RESTful

A API de Redimensionamento de PDF segue os princípios RESTful com uma estrutura de ponto final simples:

POST/resize-pdf/v1

A API aceita multipart/form-data com os seguintes parâmetros:

file: O ficheiro PDF a redimensionar (binário, máx. 10 MB)

password: Palavra-passe opcional para documentos protegidos

pages: Seleção de páginas opcional (por exemplo, "1,3,5-7")

width: Largura opcional em polegadas (0,1-200, padrão 8,3)

height: Altura opcional em polegadas (0,1-200, padrão 11,7)

Os códigos de resposta fornecem informações de estado claras:

202: Sucesso, retorna o ID da operação

400: Parâmetros de pedido inválidos

401: Falha na autenticação

413: O ficheiro excede o limite de tamanho

Implementação com SDK

Para os programadores que preferem a integração direta da biblioteca em vez de chamadas à API, o nosso SDK oferece a mesma funcionalidade com bindings de linguagem nativa. O SDK oferece benefícios adicionais, incluindo:

Redução da sobrecarga de rede para processamento de alto volume
Monitorização do progresso para operações de longa duração
Manuseamento de erros e lógica de repetição simplificados
Comportamento consistente entre plataformas
Validação automática de parâmetros

Como Funciona o Processo de Redimensionamento

1. Carregar o Documento

Selecione um ficheiro PDF para redimensionar, carregando-o a partir do seu sistema local ou de um serviço de armazenamento na nuvem (Google Drive, Dropbox, etc.). A API aceita carregamentos diretos de ficheiros ou referências de ficheiros, suportando documentos até 10 MB de tamanho. Para a integração programática, implemente um carregamento de formulário multipart padrão ou forneça um fluxo de ficheiros diretamente para o ponto final da API.

2. Definir Parâmetros

Especifique as dimensões do documento e as opções de processamento desejadas:

Definir as medidas exatas de largura e altura (em polegadas)

Definir margens personalizadas para um controlo preciso do layout

Especificar quais as páginas a processar (todas as páginas por defeito)

Fornecer a palavra-passe para documentos protegidos, se necessário

3. Processar e Obter Resultado

A API processa o seu documento de acordo com os parâmetros especificados e disponibiliza o PDF redimensionado para transferência. Para operações assíncronas, monitorize o ponto final do estado da operação até que o processamento esteja concluído e, em seguida, recupere o documento finalizado. Todos os ficheiros processados são removidos automaticamente após a transferência para manter a segurança do documento.

Você Sabia?

As margens não são uma invenção moderna. Até os nossos antepassados usavam margens para os ajudar a formatar o seu texto! As margens foram usadas pela primeira vez nos antigos rolos de papiro egípcios. Como os rolos eram desenrolados horizontalmente, as colunas de texto eram separadas por margens para indicar ao leitor quando passar para a linha seguinte.