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.
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.
| Parametro | Necessario | Cosa fa | Esempio |
|---|---|---|---|
| jobIdExt | Optional | Your own reference for this call. It is stored with the API call log so you can correlate calls with your jobs. Type: string. | |
| integrations | Optional | Integration identifiers, forwarded unchanged with the job's notification settings. Type: array. | |
| isAsync | Optional | Set 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 |
| docName | Optional | Source 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 |
| docContent | Required | The 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... |
| docContentBytes | Optional | Alternative raw byte payload for the source file. Type: string. | |
| callBackUrl | Optional | Optional URL notified when an asynchronous job completes. Type: string. | |
| alignX | Optional | An unrecognised value is rejected with 400. Type: string. | right |
| alignY | Optional | An unrecognised value is rejected with 400. Type: string. | bottom |
| fontSize | Optional | Required. Font size of the page numbers, greater than 0; 0 or less is rejected with 400 (`Invalid FontSize`). Type: integer. | 12 |
| isBold | Optional | Make the page numbers bold. Type: boolean. | true |
| isItalic | Optional | Make the page numbers italic. Type: boolean. | false |
| pageNumberFormat | Optional | Text 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} |
| skipFirstPage | Optional | Do not number the first page. Type: boolean. | false |
| marginXinMM | Optional | Horizontal distance in millimetres from the edge chosen by `alignX`. Negative values count as 0. Type: integer. | 2 |
| marginYinMM | Optional | Vertical 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.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
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:
- Estrarre il
docContentcampo dal JSON risposta - decodificare il Base64 stringa per ottenere il binario PDF dati
- 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
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:
- Estrarre il
Locationintestazione dalla risposta 202 - Sondare il URL utilizzando GET richieste
- Continua a fare sondaggi finché non ricevi un 200 OK stati
- La risposta finale contiene lo stesso JSON formato con
docNameEdocContentBase64)
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
}
Risposte di errore
IL API resi standard HTTP Codici di errore con dettagli dell'errore:
- 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)
- Non valido o mancante API chiave
- API chiave non corretta Base64 codificato in Authorization intestazione
- Mancante
Autorizzazione: Baseintestazione
- 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"
}
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 utilizzareAuthorization: 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#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
C# Esempio (CSharp)
Completo C# implementazione per aggiungere i numeri di pagina a PDF:
Java Campione
Java implementazione con gestione completa degli errori ed elaborazione delle risposte:
JavaScript Campione
Node.js e compatibile con i browser JavaScript implementazione:
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
- Education & Research
- Business & Enterprise
- Government & Compliance
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.
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
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
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