Aggiungi margine a PDF - Formattatore di layout API

PDF4me Aggiungi margine a PDF consente di aggiungere margini personalizzati a qualsiasi lato di un PDF documento. Questo API processi di servizio PDF file e aggiunge margini in millimetri, regolando di conseguenza le dimensioni della pagina per adattarsi ai margini. API riceve PDF contenuto attraverso REST API chiamate, utilizzando Base64 Codifica per una trasmissione sicura. Questa soluzione è ideale per la formattazione dei documenti, la preparazione alla stampa e per garantire layout di pagina uniformi per documenti professionali.

Articoli correlati del blog

Non ci sono ancora post sul blog dedicati a questa funzionalità — in arrivo a breve.

Nel frattempo, dai un'occhiata al blog di PDF4me per trovare tutorial e procedure operative su tutte le piattaforme.

Visita il blog →

Autenticazione del tuo API Richiesta

Per accedere al PDF4me REST API, ogni richiesta deve includere credenziali di autenticazione adeguate. L'autenticazione garantisce una comunicazione sicura e convalida la tua identità come utente autorizzato del REST API.

Get your api Key

Caratteristiche principali

• Controllo del margine individualeImposta margini diversi per i lati superiore, inferiore, sinistro e destro in modo indipendente.
• Precisione millimetricaTutti i margini sono specificati in millimetri (intervallo 0-100).
• Regolazione delle dimensioni della pagina: Le dimensioni della pagina vengono regolate automaticamente per adattarsi ai margini aggiunti
• Conservazione dei documenti: Mantiene il contenuto originale adattando il layout
• Elaborazione asincronaSupporto per l'elaborazione asincrona con polling per operazioni di lunga durata

REST API Punto finale

IL PDF4me REST API utilizza standard HTTP metodi per interagire con le risorse. Tutte le operazioni di aggiunta del margine vengono eseguite tramite un unico endpoint:

• Metodo: POST
• Punto finale: /api/v2/AddMargin

REST API Parametri

Elenco completo dei parametri per Aggiungi margine a PDF REST APII parametri sono organizzati per categoria per una migliore comprensione e implementazione.

Importante: I parametri contrassegnati da un asterisco (*) sono obbligatori e devono essere forniti per il API per funzionare correttamente.

Parametri richiesti

Parametro	Tipo	Descrizione	Esempio
docName*	String	Produzione PDF nome del file con estensione .pdf	output.pdf
docContent*	Base64	PDF contenuto del file codificato in Base64	JVBERi...

Parametri opzionali

Parametro	Tipo	Descrizione	Esempio
margine sinistro	Integer	Margine sinistro in millimetri (0-100). Se non specificato, non viene aggiunto alcun margine sinistro.	20
margine destro	Integer	Margine destro in millimetri (0-100). Se non specificato, non viene aggiunto alcun margine destro.	20
margine superiore	Integer	Margine superiore in millimetri (0-100). Se non specificato, non viene aggiunto alcun margine superiore.	25
margineInferiore	Integer	Margine inferiore in millimetri (0-100). Se non specificato, non viene aggiunto alcun margine inferiore.	25
asincrono	Boolean	Abilita l'elaborazione asincrona. Quando true, IL API restituisce uno stato 202 e fornisce un polling URL nel Location intestazione	true

Produzione

IL PDF4me Aggiungi margine a PDF REST API restituisce risposte diverse a seconda della modalità di elaborazione. API restituisce il PDF come Base64-stringa codificata in JSON formato, non come dati binari.

Success Response

Elaborazione sincrona (impostazione predefinita)

Quando async non è impostato o impostato su false, IL API elabora la richiesta immediatamente:

Codice di stato: 200 OK

Content-Type: application/json

Corpo della risposta:

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

Campi di risposta:

• docName (stringa): L'output PDF nome del file
• docContent (stringa): La PDF file con margini aggiunti, codificato come Base64 corda

Come si usa:

1. Estrarre il docContent campo dal JSON risposta
2. decodificare il Base64 stringa per ottenere il binario PDF dati
3. Salva o elabora il PDF file secondo necessità

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

Elaborazione asincrona

Quando async: true è impostato, il API elabora la richiesta in modo asincrono:

Codice di stato: 202 Accepted

Intestazioni di risposta:

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

Procedura di votazione:

1. Estrarre il Location intestazione dalla risposta 202
2. Sondare il URL utilizzando GET richieste
3. Continua a fare sondaggi finché non ricevi un 200 OK stati
4. La risposta finale contiene lo stesso JSON formato con docName E docContent Base64)

Esempio di sondaggio:

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

Risposte di errore

IL API resi standard HTTP Codici di errore con dettagli dell'errore:

400 Bad Request

• Parametri di richiesta non validi
• Campi obbligatori mancanti (docContent, docName)
• Non valido Base64 codifica in docContent
• Valori di margine non validi (devono essere numeri interi compresi tra 0 e 100)

401 Unauthorized

• Non valido o mancante API chiave
• API chiave non corretta Base64 codificato in Authorization intestazione
• Mancante Autorizzazione: Base intestazione

500 Internal Server Error

• Errore di elaborazione lato server
• PDF errore di elaborazione
• Mancato aumento del margine

Formato della risposta di errore:

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

Response Format Details

Dettagli sul formato di risposta

Importante: IL API ritorna sempre JSONmai binario PDF dati direttamente.

Struttura della risposta:

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

Content-Type Intestazione:

• Successo: application/json
• IL PDF è incorporato come un Base64 stringa all'interno della JSON risposta

Perché Base64?

• JSON- codifica sicura per dati binari
• Facile da trasmettere HTTP
• Compatibile con tutti i linguaggi di programmazione
• Può essere incorporato direttamente in JSON senza sfuggire ai problemi

Codifica 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);

Esempio di richiesta

Intestazione

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Nota:

• Ottieni il tuo API chiave dalla PDF4me Pannello di controllo
• IL API la chiave deve essere Base64 codificato e prefissato con "Basic" nel Authorization intestazione
• Esempio: se il tuo API la chiave è abc123, codificalo in Base64 e utilizzare Authorization: Basic YWJjMTIz

Carico utile

Esempio di base (solo campi obbligatori):

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

Esempio avanzato (con tutti i campi opzionali):

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

Esempi di codice

IL PDF4me Aggiungi margine a PDF REST API Fornisce esempi di codice in diversi linguaggi di programmazione. Scegli il linguaggio più adatto al tuo ambiente di sviluppo:

C#

C# CSharp) Campione

Completo C# implementazione per aggiungere margini a PDF:

View C# Sample

Java

Java Campione

Java implementazione con gestione completa degli errori ed elaborazione delle risposte:

View Java Sample

JavaScript

JavaScript Campione

Node.js e compatibile con i browser JavaScript implementazione:

View JavaScript Sample

Python

Python Campione

Python implementazione con libreria requests e JSON gestione:

View Python Sample

Salesforce

Salesforce Campione

Salesforce implementazione con Apex E HTTP didascalie:

View Salesforce Sample

n8n

n8n Campione

n8n implementazione del flusso di lavoro con HTTP nodi di richiesta:

View n8n Sample

Google Script

Google Script Campione

Google Apps Script implementazione con UrlFetchApp:

View Google Script Sample

AWS Lambda

AWS Lambda Campione

AWS Lambda implementazione con Node.js E API Gateway:

View AWS Lambda Sample

PDF Caratteristiche del margine

Controllo dei margini

• Controllo individualeImposta margini diversi per ciascun lato del documento (superiore, inferiore, sinistro, destro).
• Precisione millimetrica: Tutti i margini sono specificati in millimetri con un intervallo da 0 a 100
• Regolazione delle dimensioni della pagina: Le dimensioni della pagina vengono regolate automaticamente per adattarsi ai margini aggiunti
• Conservazione del layout: Mantenere la struttura del documento durante la regolazione dei margini

Miglioramento del documento

• Ottimizzazione della stampa: Assicurarsi che i documenti vengano stampati correttamente su vari formati di carta
• Formattazione professionale: Creare layout di documento coerenti tra i team
• Conservazione dei contenuti: Originale PDF Il contenuto viene mantenuto mentre vengono aggiunti i margini

Casi d'uso e applicazioni industriali

Legal & Professional Services

Casi d'uso per servizi legali e professionali

• Documenti legali: Garantire la conformità agli standard di formattazione dei documenti legali
• Formattazione del contratto: Formattare contratti e accordi con margini adeguati
• Documenti del tribunale: Preparare documenti giudiziari con i margini standard richiesti
• Documentazione di conformitàFormattare i documenti di conformità per soddisfare gli standard normativi

Education & Research

Casi d'uso in ambito educativo e di ricerca.

• Articoli accademiciFormattare articoli di ricerca e tesi in modo da soddisfare i requisiti di pubblicazione.
• Documenti di ricercaFormattare i documenti di ricerca con margini adeguati per la pubblicazione.
• Formattazione della tesiFormattare tesi e dissertazioni in modo che soddisfino gli standard accademici.
• Materiali didatticiFormattare i documenti didattici con margini uniformi

Business & Enterprise

Casi d'uso aziendali e per le imprese

• Formattazione del documento: Standardizzare i margini nei documenti aziendali
• Rapporti aziendali: Crea report professionali con un layout coerente
• Materiale di presentazioneMigliorare l'aspetto visivo dei documenti di presentazione
• Documentazione aziendaleFormatta i documenti aziendali con margini standard

Publishing & Printing

Casi d'uso di editoria e stampa

• Preparazione alla stampaOttimizza i PDF per specifiche esigenze di stampa
• Formattazione del libroFormattare libri e pubblicazioni con margini adeguati.
• Impaginazione della rivista: Preparare layout di riviste con margini standard
• Produzione di stampaOttimizzare i documenti per i requisiti di produzione di stampa.

Richiedi assistenza

Get Your API KeyAPI SamplesGetting Started