Adicionar margem a PDF Formatador de layout API

PDF4me Adicionar margem a PDF Permite adicionar margens personalizadas a qualquer lado de um PDF documento. Este API processos de serviço PDF O editor cria arquivos e adiciona margens em milímetros, ajustando o tamanho da página de acordo para acomodar as margens. API recebe PDF conteúdo através de REST API chamadas, utilizando Base64 Codificação para transmissão segura. Esta solução é ideal para formatação de documentos, preparação para impressão e para garantir layouts de página consistentes em documentos profissionais.

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

• Controle de Margem IndividualDefina margens diferentes para as laterais superior, inferior, esquerda e direita de forma independente.
• Precisão milimétricaTodas as margens são especificadas em milímetros (intervalo de 0 a 100).
• Ajuste do tamanho da páginaO tamanho da página é ajustado automaticamente para acomodar as margens adicionadas.
• Preservação de DocumentosMantém o conteúdo original enquanto ajusta o layout.
• Processamento assíncronoSuporte para processamento assíncrono com polling para operações de longa duração.

REST API Ponto final

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

• Método: POST
• Ponto final: /api/v2/AddMargin

REST API Parâmetros

Lista completa de parâmetros para Adicionar Margem a PDF 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 e devem ser fornecidos para o API para funcionar corretamente.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição	Exemplo
nomeDoDocumento*	String	Saída PDF nome do arquivo com extensão .pdf	output.pdf
conteúdo do documento*	Base64	PDF conteúdo do arquivo codificado em Base64	JVBERi...

Parâmetros opcionais

Parâmetro	Tipo	Descrição	Exemplo
margemEsquerda	Integer	Margem esquerda em milímetros (0-100). Se não for especificada, nenhuma margem esquerda será adicionada.	20
margemDireita	Integer	Margem direita em milímetros (0-100). Se não for especificada, nenhuma margem direita será adicionada.	20
margem superior	Integer	Margem superior em milímetros (0-100). Se não for especificada, nenhuma margem superior será adicionada.	25
margemInferior	Integer	Margem inferior em milímetros (0-100). Se não for especificada, nenhuma margem inferior será adicionada.	25
assíncrono	Boolean	Ative o processamento assíncrono. Quando true, o API retorna o status 202 e fornece uma opção de sondagem. URL no Location cabeçalho	true

Saída

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

Success Response

Processamento síncrono (padrão)

Quando async não está definido ou está definido como false, o API processa a solicitação imediatamente:

Código de status: 200 OK

Content-Type: application/json

Corpo da resposta:

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}

Campos de resposta:

• nomeDoDocumento (string): A saída PDF nome do arquivo
• conteúdo do documento (string): O PDF arquivo com margens adicionadas, codificado como Base64 corda

Como usar:

1. Extraia o docContent campo do JSON resposta
2. Decifre o Base64 string para obter o binário PDF dados
3. Salvar ou processar o PDF arquive conforme necessário

Exemplo (JavaScript):

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

Asynchronous Processing

Processamento assíncrono

Quando async: true está definido, o API processa a solicitação de forma assíncrona:

Código de status: 202 Accepted

Cabeçalhos de resposta:

Location: https://api.pdf4me.com/api/v2/AddMargin/poll/12345-abcde-67890

Processo de votação:

1. Extraia o Location cabeçalho da resposta 202
2. Faça a pesquisa URL usando GET solicitações
3. Continue votando até receber um 200 OK status
4. A resposta final contém o mesmo JSON formato com docName e docContent (Base64)

Exemplo de votação:

// Initial request returns 202 with Location header
const response = await fetch(url, options);
const location = response.headers.get('Location');

// Poll until complete
while (true) {
  const pollResponse = await fetch(location, { headers: { 'Authorization': 'Basic ' + apiKey } });
  if (pollResponse.status === 200) {
    const data = await pollResponse.json();
    // Process data.docContent (Base64 PDF)
    break;
  }
  await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
}

Error Responses

Respostas de erro

O API retorna padrão HTTP Códigos de erro com detalhes do erro:

400 Bad Request

• Parâmetros de solicitação inválidos
• Campos obrigatórios ausentes (conteúdo do documento, nomeDoDocumento)
• Inválido Base64 codificação em conteúdo do documento
• Valores de margem inválidos (devem ser números inteiros entre 0 e 100)

401 Unauthorized

• Inválido ou ausente API chave
• API chave não está corretamente Base64 codificado em Authorization cabeçalho
• Ausente Autorização: Básica cabeçalho

500 Internal Server Error

• Erro de processamento no servidor
• PDF falha de processamento
• Falha na adição de margem

Formato da resposta de erro:

{
  "error": "Error message describing what went wrong"
}

Response Format Details

Detalhes do formato da resposta

Importante: O API sempre retorna JSON, nunca binário PDF dados diretamente.

Estrutura da resposta:

{
  "docName": "string",      // Output PDF filename
  "docContent": "string"    // Base64-encoded PDF content
}

Content-Type Cabeçalho:

• Sucesso: application/json
• O PDF está incorporado como um Base64 string dentro do JSON resposta

Por que Base64?

• JSON-Codificação segura para dados binários
• Fácil de transmitir HTTP
• Compatível com todas as linguagens de programação.
• Pode ser incorporado diretamente em JSON sem escapar dos problemas

Decodificando Base64 para PDF:

JavaScript/Node.js:

const base64 = response.docContent;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64').toString('binary'); // Node.js

Python:

import base64
pdf_bytes = base64.b64decode(response['docContent'])
with open('output.pdf', 'wb') as f:
    f.write(pdf_bytes)

C#:

byte[] pdfBytes = Convert.FromBase64String(response.docContent);
File.WriteAllBytes("output.pdf", pdfBytes);

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 (somente campos obrigatórios):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}

Exemplo avançado (com todos os campos opcionais):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "marginLeft": 20,
  "marginRight": 20,
  "marginTop": 25,
  "marginBottom": 25,
  "async": true
}

Exemplos de código

O PDF4me Adicionar margem a PDF 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#

C# (CSharp) Amostra

Completo C# implementação para adicionar margens a PDF:

View C# Sample

Java

Java Amostra

Java Implementação com tratamento completo de erros e processamento de respostas:

View Java Sample

JavaScript

JavaScript Amostra

Node.js e compatível com navegadores JavaScript Implementação:

View JavaScript Sample

Python

Python Amostra

Python implementação com a biblioteca requests e JSON manuseio:

View Python Sample

Salesforce

Salesforce Amostra

Salesforce implementação com Apex e HTTP chamadas:

View Salesforce Sample

n8n

n8n Amostra

n8n implementação de fluxo de trabalho com HTTP nós de solicitação:

View n8n Sample

Google Script

Google Script Amostra

Google Apps Script Implementação com UrlFetchApp:

View Google Script Sample

AWS Lambda

AWS Lambda Amostra

AWS Lambda implementação com Node.js e API Portal:

View AWS Lambda Sample

PDF Características de margem

Controle de Margem

• Controle individualDefina margens diferentes para cada lado do documento (superior, inferior, esquerda, direita).
• Precisão milimétricaTodas as margens são especificadas em milímetros, com uma escala de 0 a 100.
• Ajuste do tamanho da páginaO tamanho da página é ajustado automaticamente para acomodar as margens adicionadas.
• Preservação do LayoutManter a estrutura do documento enquanto ajusta as margens.

Aprimoramento de Documentos

• Otimização de ImpressãoGarantir que os documentos sejam impressos corretamente em diversos tamanhos de papel.
• Formatação profissionalCriar layouts de documentos consistentes entre as equipes.
• Preservação de Conteúdo: Original PDF O conteúdo é mantido enquanto as margens são adicionadas.

Casos de uso e aplicações industriais

Legal & Professional Services

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

• Documentos LegaisGarantir a conformidade com os padrões legais de formatação de documentos.
• Formatação de ContratosFormate contratos e acordos com margens adequadas.
• Documentos judiciaisPreparar documentos judiciais com margens padrão.
• Documentação de ConformidadeFormatar documentos de conformidade para atender aos padrões regulamentares

Education & Research

Casos de uso em educação e pesquisa

• Artigos acadêmicosFormatar trabalhos de pesquisa e teses para atender aos requisitos de publicação.
• Documentos de pesquisaFormate os trabalhos de pesquisa com margens adequadas para publicação.
• Formatação de teseFormatar teses e dissertações de acordo com os padrões acadêmicos.
• Materiais EducacionaisFormate documentos educacionais com margens consistentes.

Business & Enterprise

Casos de uso para empresas e negócios

• Formatação de documentosPadronizar as margens em todos os documentos corporativos.
• Relatórios de negóciosCrie relatórios profissionais com layout consistente.
• Materiais de apresentaçãoMelhorar o apelo visual dos documentos de apresentação.
• Documentação CorporativaFormate documentos corporativos com margens padrão.

Publishing & Printing

Casos de uso em publicação e impressão

• Preparação para impressãoOtimizar PDFs para requisitos de impressão específicos
• Formatação de livrosFormate livros e publicações com margens adequadas.
• Layout de revistaPrepare layouts de revistas com margens padrão.
• Produção GráficaOtimizar documentos para requisitos de produção de impressão

Obtenha ajuda

Get Your API KeyAPI SamplesGetting Started