Passa al contenuto principale

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.

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.

ParametroNecessarioCosa faEsempio
jobIdExtOptionalYour own reference for this call. It is stored with the API call log so you can correlate calls with your jobs. Type: string.
integrationsOptionalIntegration identifiers, forwarded unchanged with the job's notification settings. Type: array.
isAsyncOptionalSet to `true` to process the action asynchronously and get a job to poll at `/api/v2/GetActionStatus`. Only honoured by actions that support asynchronous processing. Type: boolean.true
docNameOptionalSource file name including its extension. Several actions dispatch on the extension, so it should always be set; when omitted a per-action default is used. Type: string.output.pdf
docContentRequiredThe source file. Accepts the base64-encoded file content, a `pdf4meblobid://<id>` reference to a previously uploaded blob, or an `https` URL to the source document. Required: an empty value fails with `File is empty`. Type: string.JVBERi...
docContentBytesOptionalAlternative raw byte payload for the source file. Type: string.
callBackUrlOptionalOptional URL notified when an asynchronous job completes. Type: string.
alignXOptionalAn unrecognised value is rejected with 400. Type: string.right
alignYOptionalAn unrecognised value is rejected with 400. Type: string.bottom
fontSizeOptionalRequired. Font size of the page numbers, greater than 0; 0 or less is rejected with 400 (`Invalid FontSize`). Type: integer.12
isBoldOptionalMake the page numbers bold. Type: boolean.true
isItalicOptionalMake the page numbers italic. Type: boolean.false
pageNumberFormatOptionalText of the page number, where `#` is the current page and `{1}` the total number of pages, e.g. `Page # of {1}`. Type: string.# of {1}
skipFirstPageOptionalDo not number the first page. Type: boolean.false
marginXinMMOptionalHorizontal distance in millimetres from the edge chosen by `alignX`. Negative values count as 0. Type: integer.2
marginYinMMOptionalVertical distance in millimetres from the edge chosen by `alignY`. Negative values count as 0. Type: integer.2

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.

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

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# Esempio (CSharp)

Completo C# implementazione per aggiungere i numeri di pagina a PDF:

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​

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.

Richiedi assistenza​