Agregar margen a PDF - Formateador de diseño API

PDF4me Agregar margen a PDF le permite agregar márgenes personalizados a cualquier lado de un PDF documento. Este API procesos de servicio PDF archivos y agrega márgenes en milímetros, ajustando el tamaño de la página en consecuencia para acomodar los márgenes. API recibe PDF contenido a través de REST API llamadas, utilizando Base64 Codificación para una transmisión segura. Esta solución es ideal para formatear documentos, prepararlos para impresión y garantizar un diseño de página uniforme en documentos profesionales.

Entradas de blog relacionadas

Aún no hay ninguna entrada de blog sobre esta función; estará disponible próximamente.

Mientras tanto, echa un vistazo al blog de PDF4me para encontrar tutoriales y flujos de trabajo para todas las plataformas.

Visita el blog →

Autenticando su API Pedido

Para acceder al PDF4me REST APICada solicitud debe incluir las credenciales de autenticación adecuadas. La autenticación garantiza una comunicación segura y valida su identidad como usuario autorizado del sistema. REST API.

Get your api Key

Características principales

• Control de margen individual: Establezca márgenes diferentes para los lados superior, inferior, izquierdo y derecho de forma independiente.
• Precisión milimétricaTodos los márgenes se especifican en milímetros (rango de 0 a 100).
• Ajuste del tamaño de páginaEl tamaño de la página se ajusta automáticamente para dar cabida a los márgenes añadidos.
• Conservación de documentosMantiene el contenido original mientras ajusta el diseño.
• Procesamiento asíncrono: Compatibilidad con el procesamiento asíncrono mediante sondeo para operaciones de larga duración.

REST API Punto final

El PDF4me REST API utiliza estándar HTTP métodos para interactuar con los recursos. Todas las operaciones de adición de margen se realizan a través de un único punto final:

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

REST API Parámetros

Lista completa de parámetros para Agregar margen a PDF REST APILos parámetros están organizados por categoría para una mejor comprensión e implementación.

Importante: Los parámetros marcados con un asterisco (*) son obligatorios y deben proporcionarse para la API para que funcione correctamente.

Parámetros requeridos

Parámetro	Tipo	Descripción	Ejemplo
Nombre del documento*	String	Producción PDF Nombre del archivo con extensión .pdf	output.pdf
docContent*	Base64	PDF contenido del archivo codificado en Base64	JVBERi...

Parámetros opcionales

Parámetro	Tipo	Descripción	Ejemplo
margen izquierdo	Integer	Margen izquierdo en milímetros (0-100). Si no se especifica, no se añade margen izquierdo.	20
margenDerecha	Integer	Margen derecho en milímetros (0-100). Si no se especifica, no se añade margen derecho.	20
margen superior	Integer	Margen superior en milímetros (0-100). Si no se especifica, no se añade margen superior.	25
margen inferior	Integer	Margen inferior en milímetros (0-100). Si no se especifica, no se añade margen inferior.	25
asíncrono	Boolean	Habilitar el procesamiento asíncrono. Cuando true, el API devuelve un estado 202 y proporciona una encuesta URL en el Location encabezado	true

Producción

El PDF4me Agregar margen a PDF REST API devuelve diferentes respuestas según el modo de procesamiento. API devuelve el PDF como un Base64cadena codificada en JSON formato, no como datos binarios.

Success Response

Procesamiento síncrono (predeterminado)

Cuando async no está configurado o está configurado false, el API procesa la solicitud inmediatamente:

Código de estado: 200 OK

Content-Type: application/json

Cuerpo de la respuesta:

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

Campos de respuesta:

• Nombre del documento (cadena): La salida PDF Nombre del archivo
• docContent (cadena): El PDF archivo con márgenes añadidos, codificado como Base64 cadena

Cómo usarlo:

1. Extraer el docContent campo del JSON respuesta
2. Decodifica el Base64 cadena para obtener el binario PDF datos
3. Guardar o procesar el PDF Archivo según sea necesario

Ejemplo (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

Procesamiento asíncrono

Cuando async: true está establecido, el API procesa la solicitud de forma asíncrona:

Código de estado: 202 Accepted

Encabezados de respuesta:

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

Proceso de votación:

1. Extraer el Location encabezado de la respuesta 202
2. Encuesta la URL usando GET solicitudes
3. Continúe realizando encuestas hasta que reciba una 200 OK estado
4. La respuesta final contiene lo mismo JSON formato con docName y docContent (Base64)

Ejemplo de encuesta:

// 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

Respuestas de error

El API devuelve estándar HTTP Códigos de error con detalles del error:

400 Bad Request

• Parámetros de solicitud no válidos
• Faltan campos obligatorios (docContent, Nombre del documento)
• Inválido Base64 codificación en docContent
• Valores de margen no válidos (deben ser números enteros entre 0 y 100).

401 Unauthorized

• Inválido o faltante API llave
• API La llave no funciona correctamente. Base64 codificado en Authorization encabezado
• Desaparecido Autorización: Básica encabezado

500 Internal Server Error

• Error de procesamiento del servidor
• PDF fallo de procesamiento
• Fallo en la adición de márgenes

Formato de respuesta de error:

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

Response Format Details

Detalles del formato de respuesta

Importante: El API siempre regresa JSON, nunca binario PDF datos directamente.

Estructura de respuesta:

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

Content-Type Encabezado:

• Éxito: application/json
• El PDF está incrustado como un Base64 cadena dentro de la JSON respuesta

Por qué Base64¿

• JSON-Codificación segura para datos binarios
• Fácil de transmitir HTTP
• Compatible con todos los lenguajes de programación.
• Se puede integrar directamente en JSON sin escapar de los problemas

Decodificación Base64 a 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);

Ejemplo de solicitud

Encabezamiento

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Nota:

• Consigue tu API clave del PDF4me Panel
• El API La clave debe ser Base64 codificado y prefijado con "Basic" en el Authorization encabezado
• Ejemplo: Si su API La clave es abc123, codificarlo a Base64 y usar Authorization: Basic YWJjMTIz

Carga útil

Ejemplo básico (solo campos obligatorios):

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

Ejemplo avanzado (con todos los campos opcionales):

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

Ejemplos de código

El PDF4me Agregar margen a PDF REST API Proporciona ejemplos de código en varios lenguajes de programación. Elija el lenguaje que mejor se adapte a su entorno de desarrollo:

C#

C# (CSharp) Muestra

Completo C# implementación para agregar márgenes a PDF:

View C# Sample

Java

Java Muestra

Java Implementación con manejo completo de errores y procesamiento de respuestas:

View Java Sample

JavaScript

JavaScript Muestra

Node.js y compatible con navegadores JavaScript implementación:

View JavaScript Sample

Python

Python Muestra

Python implementación con la biblioteca requests y JSON manejo:

View Python Sample

Salesforce

Salesforce Muestra

Salesforce implementación con Apex y HTTP llamadas:

View Salesforce Sample

n8n

n8n Muestra

n8n implementación de flujo de trabajo con HTTP nodos de solicitud:

View n8n Sample

Google Script

Google Script Muestra

Google Apps Script Implementación con UrlFetchApp:

View Google Script Sample

AWS Lambda

AWS Lambda Muestra

AWS Lambda implementación con Node.js y API Puerta de enlace:

View AWS Lambda Sample

PDF Características de margen

Control de márgenes

• Control individual: Establezca márgenes diferentes para cada lado del documento (superior, inferior, izquierdo, derecho).
• Precisión milimétrica: Todos los márgenes se especifican en milímetros con un rango de 0 a 100.
• Ajuste del tamaño de páginaEl tamaño de la página se ajusta automáticamente para dar cabida a los márgenes añadidos.
• Preservación del diseño: Mantener la estructura del documento mientras se ajustan los márgenes.

Mejora de documentos

• Optimización de impresiónAsegúrese de que los documentos se impriman correctamente en distintos tamaños de papel.
• Formato profesional: Crear diseños de documentos consistentes en todos los equipos
• Preservación de contenido: Original PDF El contenido se mantiene mientras se agregan márgenes.

Casos de uso y aplicaciones en la industria

Legal & Professional Services

Casos de uso de servicios legales y profesionales

• Documentos legalesGarantizar el cumplimiento de las normas de formato de documentos legales.
• Formato de contratoFormatear contratos y acuerdos con márgenes adecuados.
• Documentos judiciales: Preparar documentos judiciales con márgenes estándar.
• Documentación de cumplimientoFormatear los documentos de cumplimiento para que cumplan con los estándares reglamentarios.

Education & Research

Casos de uso en educación e investigación

• Artículos académicosFormatear artículos de investigación y tesis para cumplir con los requisitos de publicación.
• Documentos de investigaciónFormatear los trabajos de investigación con márgenes adecuados para su publicación.
• Formato de tesisFormatear tesis y disertaciones para que cumplan con los estándares académicos.
• Materiales educativosFormatear los documentos educativos con márgenes uniformes.

Business & Enterprise

Casos de uso para empresas y negocios

• Formato de documentos: Estandarizar los márgenes en todos los documentos corporativos
• Informes empresarialesCree informes profesionales con un diseño uniforme.
• Materiales de presentación: Mejora el atractivo visual de los documentos de presentación
• Documentación corporativaFormatear documentos corporativos con márgenes estándar.

Publishing & Printing

Casos de uso de publicación e impresión

• Preparación de impresiónOptimizar archivos PDF para requisitos de impresión específicos.
• Formato de libroFormatear libros y publicaciones con márgenes adecuados.
• Diseño de revista: Preparar maquetaciones de revistas con márgenes estándar.
• Producción de impresiónOptimizar los documentos para los requisitos de producción de impresión.

Obtén ayuda

Get Your API KeyAPI SamplesGetting Started