Eliminare pagine da Word - Gestione pagine API
PDF4me Eliminare pagine da Word consente di rimuovere pagine specifiche o intervalli di pagine da documenti Word con opzioni di selezione delle pagine flessibili. Questo API Il servizio elabora i file Word ed elimina le pagine utilizzando l'eliminazione basata su intervallo (dalla pagina iniziale alla pagina finale), l'eliminazione in base a numeri di pagina specifici (elenchi separati da virgole) e modelli di eliminazione combinati. API riceve il contenuto del documento Word tramite REST API chiamate, utilizzando Base64 Codifica per una trasmissione sicura. Grazie al supporto per il controllo completo sulla selezione delle pagine, l'ottimizzazione dei documenti e la pulizia dei contenuti, questa soluzione è ideale per i flussi di lavoro di perfezionamento, gestione dei contenuti e preparazione dei documenti.
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
- Selezione flessibile delle pagineElimina le pagine per intervallo, per numeri specifici o per una combinazione di entrambi.
- Eliminazione basata su intervalli: Rimuovere le pagine consecutive dalla pagina iniziale alla pagina finale
- Eliminazione di pagine specifiche: Rimuovere le singole pagine utilizzando i numeri di pagina separati da virgole
- Ottimizzazione dei documenti: Pulire i documenti rimuovendo i contenuti indesiderati
- Conservazione del formato: Mantenere la formattazione e la struttura originali del documento
- Conservazione dei metadati: Mantieni le proprietà del documento e i metadati personalizzati
- Validazione: Validazione automatica del numero di pagina e gestione degli errori
- Supporto culturaleElaborazione dei documenti specifici per la località
REST API Punto finale
IL PDF4me REST API utilizza standard HTTP metodi per interagire con le risorse. Tutte le operazioni di eliminazione delle pagine vengono eseguite tramite un unico endpoint:
- Metodo: POST
- Punto finale:
office/ApiV2Word/DeletePages
REST API Parametri
Elenco completo dei parametri per Elimina pagine da Word REST APII parametri sono organizzati per categoria per una migliore comprensione e implementazione.
Importante: I parametri contrassegnati da un asterisco (*) sono obbligatori. È necessario specificare almeno un parametro per l'eliminazione delle pagine (startPage, endPage o pageNumbers).
Parametri richiesti
| Parametro | Tipo | Descrizione | Esempio |
|---|---|---|---|
| documento* | Object | Riferimento al documento. Deve contenere Nome (stringa): Nome del file Word con estensione .docx | { "Name": "document.docx" } |
| docContent* | Base64 | Il contenuto del documento Word codificato in Base64 | UEsDBBQABgAIAAAA... |
Parametri opzionali (almeno uno è obbligatorio per la cancellazione della pagina)
| Parametro | Tipo | Descrizione | Esempio |
|---|---|---|---|
| Pagina iniziale | Integer | Numero di pagina iniziale (indice basato su 1). Numero di pagina da cui iniziare la cancellazione. Deve essere maggiore o uguale a 1 e minore o uguale al numero di pagine del documento. Se viene fornito solo startPage, la cancellazione inizia da questa pagina e termina alla fine del documento. Non può essere maggiore di endPage. | 2 |
| finepagina | Integer | Numero di pagina finale (indice basato su 1). Numero di pagina a cui interrompere la cancellazione. Deve essere maggiore o uguale a startPage e minore o uguale al numero di pagine del documento. L'intervallo è inclusivo (vengono eliminate sia la pagina iniziale che quella finale). Può essere combinato con pageNumbers per modelli di cancellazione complessi. | 5 |
| numeri di pagina | String | Elenco di numeri di pagina specifici da eliminare, separati da virgole. Formato: "1,3,4" o "1-3,5,7-9". Può essere utilizzato da solo o in combinazione con startPage/endPage. I numeri di pagina non validi vengono ignorati silenziosamente. Esempio: "2,4,6,8" elimina le pagine 2, 4, 6 e 8. | "2,4,6" |
| Nome della cultura | String | Codice cultura per l'elaborazione del documento (ad esempio, "en-US", "de-DE", "fr-FR"). Valore predefinito: null (nessuna elaborazione specifica per la cultura). Influisce sulla lingua e sulla formattazione del documento. | en-US |
Modalità di eliminazione delle pagine
IL API supporta diverse modalità di eliminazione delle pagine:
- Eliminazione intervallo: Utilizzo
startPageEendPageper eliminare pagine consecutive - Eliminazione di pagine specifiche: Utilizzo
pageNumberseliminare singole pagine - Eliminazione combinataUtilizzare contemporaneamente i parametri di intervallo e quelli di pagina specifica.
- Elimina per terminare: Utilizzare solo
startPageper eliminare da quella pagina alla fine del documento
Nota: Tutti i numeri di pagina sono basati su 1 (prima pagina = 1, non 0). I numeri di pagina vengono convalidati automaticamente in base al numero di pagine del documento.
Produzione
IL PDF4me Eliminare pagine da Word REST API restituisce risposte diverse a seconda della modalità di elaborazione. API restituisce il documento Word come un Base64-stringa codificata in JSON formato, non come dati binari.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Elaborazione sincrona (impostazione predefinita)
IL API elabora la richiesta e restituisce:
Codice di stato: 200 OK
Tipo di contenuto: application/json
Corpo della risposta:
{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "document.docx",
"success": true,
"errorMessage": null
}
Campi di risposta:
- documento (stringa): Il documento Word con le pagine specificate eliminate, codificato come Base64 corda
- Nome file (stringa): Il nome del file Word di output
- successo (booleano): Indica se la richiesta è andata a buon fine
- messaggio di errore (stringa o null): Dettagli dell'errore quando il successo è falso
Come si usa:
- Estrarre il
documentcampo dal JSON risposta (Base64) - decodificare il Base64 stringa per ottenere i dati binari del documento Word
- Salva o elabora il file Word secondo necessità.
Esempio (JavaScript):
const response = await fetch(url, options);
const data = await response.json();
const wordBytes = atob(data.document); // Decode Base64
// Save or process wordBytes
Elaborazione asincrona
Comportamento asincrono (202 Accepted con polling) è controllato dalla configurazione del server, non da un parametro del corpo della richiesta. Quando abilitato, il API potrebbe restituire uno stato 202 con un polling URL nel Location intestazione. Interroga l' URL con GET richieste fino a quando non ne ricevi 200 OK con la stessa struttura di risposta (documento, nomefile, successo, messaggiodierrore).
Risposte di errore
IL API resi standard HTTP Codici di errore con dettagli dell'errore:
- Parametri di richiesta non validi
- Campi obbligatori mancanti (
documentoconNome,docContent) - È richiesto almeno un criterio di eliminazione della pagina (
Pagina iniziale,finepagina, Onumeri di pagina) - Non valido Base64 codifica in
docContent - Documento Word non valido o danneggiato
Pagina inizialenon può essere maggiore difinepagina- Numeri di pagina non validi (fuori dall'intervallo del documento)
- Non valido o mancante API chiave
- API chiave non corretta Base64 codificato in Authorization intestazione
- Mancante
Autorizzazione: Baseintestazione
- Errore di elaborazione lato server
- Errore nell'elaborazione del documento Word
- Errore di eliminazione della pagina
Formato della risposta di errore:
{
"error": "Error message describing what went wrong"
}
Dettagli sul formato di risposta
Importante: IL API ritorna sempre JSON, mai dati Word binari direttamente.
Struttura della risposta:
{
"document": "string", // Base64-encoded Word document content
"fileName": "string", // Output Word filename
"success": true,
"errorMessage": "string or null"
}
Intestazione Content-Type:
- Successo:
application/json - Il documento Word è incorporato come 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 al documento Word:
JavaScript/Node.js:
const base64 = response.document;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64'); // Node.js
Python:
import base64
word_bytes = base64.b64decode(response['document'])
with open('output.docx', 'wb') as f:
f.write(word_bytes)
C#:
byte[] wordBytes = Convert.FromBase64String(response.document);
File.WriteAllBytes("output.docx", wordBytes);
Esempi di eliminazione di pagine
Comprendere i diversi modelli di eliminazione delle pagine:
| Pagine del documento | Pagina iniziale | finepagina | numeri di pagina | Risultato |
|---|---|---|---|---|
| 1,2,3,4,5 | 2 | 4 | - | Conserva: 1,5 |
| 1,2,3,4,5 | 3 | - | - | Riserve: 1,2 |
| 1,2,3,4,5 | - | - | "2,4" | Conservare: 1,3,5 |
| 1,2,3,4,5 | 2 | 3 | "5" | Mansarde: 1,4 |
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 (eliminazione di un intervallo):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"startPage": 2,
"endPage": 4
}
Esempio di pagine specifiche:
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"pageNumbers": "2,4,6,8"
}
Esempio avanzato (cancellazione combinata):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"startPage": 2,
"endPage": 5,
"pageNumbers": "7,9",
"cultureName": "en-US"
}
Esempi di codice
IL PDF4me Eliminare pagine da Word 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 l'eliminazione di pagine da documenti Word:
Java Campione
Java implementazione con gestione completa degli errori ed elaborazione delle risposte:
JavaScript Campione
Node.js e compatibile con i browser JavaScript implementazione:
Google Script Campione
Google Apps Script implementazione per Google Workspace integrazione:
Casi d'uso e applicazioni industriali
- Legal & Professional Services
- Business & Enterprise
- Education & Research
- Finance & Banking
Casi d'uso per servizi legali e professionali
- Pulizia a contrattoRimuovere le pagine delle firme e gli allegati dalle copie del contratto.
- Preparazione di documenti legali: Eliminare le pagine riservate prima della distribuzione al cliente
- Ottimizzazione del deposito giudiziario: Rimuovere le pagine non necessarie per rispettare i requisiti di archiviazione
- Versioni dei documenti del cliente: Creare versioni pulite rimuovendo le note interne
Casi d'uso aziendali e per le imprese
- Ottimizzazione delle proposte: Rimuovere le pagine relative ai costi interni dalle proposte ai clienti
- Pulizia del materiale di marketing: Eliminare le pagine di contenuto obsolete dai materiali attuali
- Preparazione alla presentazioneRimuovere le diapositive di backup e gli appunti dalle presentazioni finali.
- Ottimizzazione dei risultati da consegnare al cliente: Crea versioni pulite rimuovendo i riferimenti interni
Casi d'uso in ambito educativo e di ricerca.
- Pulizia dei referti medici: Rimuovere le pagine contenenti informazioni sensibili sui pazienti
- Ottimizzazione dei documenti di ricerca: Eliminare i dati preliminari dai report finali
- Preparazione del documento di protocollo: Rimuovere le pagine di revisione interna dai protocolli pubblicati
- Documentazione di conformità: Ripulire la documentazione per le presentazioni agli enti regolatori
Casi d'uso in ambito finanziario e bancario
- Pulizia del bilancio: Rimuovere le appendici dettagliate dai riepiloghi esecutivi
- Ottimizzazione del documento di bilancio: Eliminare le pagine di dati storici dai budget correnti
- Preparazione del rapporto di auditRimuovere le pagine interne sensibili prima della distribuzione esterna.
- Pulizia dei documenti normativi: Ottimizzare i documenti per soddisfare i requisiti di presentazione