Aggiungi il numero di pagina a PDF - Paginazione API

PDF4me Aggiungi il numero di pagina a PDF consente di aggiungere numeri di pagina personalizzabili a PDF documenti con controllo su posizione, formato e stile. Questo API processi di servizio PDF file e aggiunge numeri di pagina utilizzando segnaposto di formato dove # rappresenta il numero di pagina corrente e {1} rappresenta il numero totale di pagine. API riceve PDF contenuto attraverso REST API chiamate, utilizzando Base64 Codifica per una trasmissione sicura. Questa soluzione è ideale per l'organizzazione di documenti, documenti legali, articoli accademici e aziendali. PDF flussi di lavoro.

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.

Ottieni la tua chiave API

Caratteristiche principali

• Formattazione flessibile: Scegli tra più formati di numerazione delle pagine utilizzando # per la pagina corrente e {1} per il numero totale di pagine (ad esempio, "# di 1", "Pagina #")
• Posizionamento preciso: Controllo dell'allineamento orizzontale e verticale con precisione al pixel
• Stile personalizzatoRegola la dimensione del carattere, il grassetto, il corsivo e altre opzioni di formattazione del testo.
• Controllo dei marginiImposta margini precisi in millimetri per un posizionamento ottimale
• Salta la prima paginaOpzione per escludere i numeri di pagina dalla prima pagina
• Risultati professionali: Creare una numerazione delle pagine coerente e professionale in tutti i documenti

REST API Punto finale

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

• Metodo: INVIARE
• Punto finale: /api/v2/AddPageNumber

REST API Parametri

Elenco completo dei parametri per Aggiungi numero di pagina 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*	Corda	Produzione PDF nome del file con estensione .pdf	output.pdf
docContent*	Base64	PDF contenuto del file codificato in Base64	JVBERi...
Formato del numero di pagina*	Corda	Formato di numerazione delle pagine. Utilizzare # per il numero di pagina corrente, {1} per il numero totale di pagine. Esempi: "# di 1", "Pagina #", "# / 1"	# of {1}
allineaX*	Corda	Allineamento orizzontale: Sinistra, centro, O Giusto	right
allineamentoY*	Corda	Allineamento verticale: superiore, mezzo, O metter il fondo a	bottom

Parametri opzionali

Parametro	Tipo	Descrizione	Esempio
marginXinMM	Intero	Margine orizzontale dal bordo in millimetri (0-100)	2
margineInMM	Intero	Margine verticale dal bordo in millimetri (0-100)	2
dimensione del carattere	Intero	Dimensione del carattere per i numeri di pagina (8-72)	12
Palla di ghiaccio	Booleano	Rendere i numeri di pagina in grassetto (vero) o normali (falso)	true
è corsivo	Booleano	Rendere i numeri di pagina in corsivo (vero) o normali (falso)	false
saltaPrimaPagina	Booleano	Saltare la numerazione nella prima pagina (vero) o includerla (falso)	false
asincrono	Booleano	Abilita l'elaborazione asincrona. Quando true, IL API restituisce uno stato 202 e fornisce un polling URL nel Location intestazione	true

Segnaposto per il formato del numero di pagina

IL pageNumberFormat Il parametro utilizza i seguenti segnaposto:

• # - Sostituito con il numero di pagina corrente (1, 2, 3, ecc.)
• {1} - Sostituito con il numero totale di pagine

Esempi di formato:

• "# of {1}" → Visualizza "1 di 10", "2 di 10", "3 di 10", ecc.
• "Page #" → Visualizza "Pagina 1", "Pagina 2", "Pagina 3", ecc.
• "# / {1}" → Visualizza "1 / 10", "2 / 10", "3 / 10", ecc.
• "- # -" → Visualizza "- 1 -", "- 2 -", "- 3 -", ecc.
• "[#/{1}]" → Visualizza "[1/10]", "[2/10]", "[3/10]", ecc.
• "(#)" → Visualizza "(1)", "(2)", "(3)", ecc.
• "#" → Visualizza solo il numero di pagina: "1", "2", "3", ecc.

Produzione

IL PDF4me Aggiungi il numero di pagina 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 numeri di pagina 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/AddPageNumber/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, Formato del numero di pagina, allineaX, allineamentoY)
• Non valido Base64 codifica in docContent
• Valori di allineamento non validi (devono essere "sinistra", "centro", "destra" per allineamentoX; "alto", "centro", "basso" per allineamentoY)
• Dimensione del carattere non valida (deve essere compresa tra 8 e 72)
• 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
• Errore nell'aggiunta del numero di pagina

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==",
  "pageNumberFormat": "# of {1}",
  "alignX": "right",
  "alignY": "bottom"
}

Esempio avanzato (con tutti i campi opzionali):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "pageNumberFormat": "# of {1}",
  "alignX": "right",
  "alignY": "bottom",
  "marginXinMM": 2,
  "marginYinMM": 2,
  "fontSize": 12,
  "isBold": true,
  "isItalic": false,
  "skipFirstPage": false,
  "async": true
}

Esempi di codice

IL PDF4me Aggiungi il numero di pagina 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# Esempio (CSharp)

Completo C# implementazione per aggiungere i numeri di pagina 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

Caratteristiche del numero di pagina

Opzioni di formattazione

• Formati multipliSupporto per vari stili e modelli di numerazione
• Posizionamento flessibileControllo preciso del posizionamento dei numeri di pagina
• Stile personalizzatoControllo completo sull'aspetto e sulla formattazione dei caratteri.
• Controllo della prima paginaOpzione per escludere le pagine di copertina dalla numerazione

Miglioramento del documento

• Impaginazione professionale: Creare una numerazione delle pagine coerente e professionale in tutti i documenti
• Ottimizzazione della stampaOttimizzare la numerazione delle pagine in base alle diverse esigenze di stampa.
• Distribuzione digitale: Mantenere la formattazione su diversi dispositivi di visualizzazione
• Coerenza del marchio: Applicare standard uniformi di numerazione delle pagine in tutte le organizzazioni

Funzionalità avanzate

• Elaborazione in batch: Elabora più documenti con una numerazione di pagina coerente
• Garanzia di qualità: Garantire l'integrità del numero di pagina e la corretta PDF compatibilità
• Conservazione del layout: Mantenere la struttura del documento durante l'aggiunta dei numeri di pagina
• Margini personalizzatiControllo preciso del posizionamento dei numeri di pagina

Casi d'uso e applicazioni industriali

Legal & Professional Services

Casi d'uso per servizi legali e professionali

• Documentazione legale: Numerare le pagine nei contratti, negli accordi e negli atti legali
• Documenti del tribunaleAggiungere i numeri di pagina agli atti giudiziari e ai documenti legali.
• Documentazione di conformità: Numero di pagine nei documenti di conformità e regolamentari
• Documentazione per il clienteOrganizzare i documenti dei clienti con la numerazione delle pagine.

Education & Research

Casi d'uso in ambito educativo e di ricerca.

• Articoli accademiciFormattare correttamente tesine e tesi di laurea con una numerazione appropriata delle pagine.
• Documenti di ricercaAggiungere i numeri di pagina a documenti di ricerca e pubblicazioni.
• Formattazione della tesi: Numero di pagine nelle tesi e nelle dissertazioni
• Materiali didatticiOrganizzare i documenti didattici con i numeri di pagina

Business & Enterprise

Casi d'uso aziendali e per le imprese

• Rapporti aziendali: Crea report professionali con una numerazione di pagina coerente
• Organizzazione dei documentiAggiungere i numeri di pagina a report, manuali e documenti tecnici.
• Manuali tecniciOrganizzare la documentazione tecnica con chiari riferimenti di pagina.
• Documentazione aziendaleNumerare le pagine nei documenti e nei manuali aziendali

Government & Compliance

Casi d'uso per la pubblica amministrazione e la conformità normativa.

• Documenti d'archivio: Preparare i documenti per l'archiviazione a lungo termine con numeri di pagina
• Rapporti governativiAggiungere i numeri di pagina ai rapporti e ai documenti governativi
• Documentazione normativa: Numero di pagine nei documenti normativi e di conformità
• Registri pubblici: Organizzare i documenti pubblici con la numerazione delle pagine

Richiedi assistenza

Get Your API KeyAPI SamplesGetting Started