Aggiungi testo Intestazione Piè di pagina - Excel API
PDF4me Aggiungi testo Intestazione Piè di pagina consente di aggiungere intestazioni e piè di pagina di testo personalizzabili a Excel documenti con controllo completo della formattazione. Questo API processi di servizio Excel file e aggiunge testo alle sezioni di intestazione o piè di pagina con stile del carattere (famiglia, dimensione, colore), livelli di trasparenza, angoli di rotazione e opzioni di orientamento (orizzontale, verticale, diagonale, capovolto). API riceve Excel contenuto del documento attraverso REST API chiamate, utilizzando Base64 Codifica per una trasmissione sicura. Questa soluzione è ideale per la personalizzazione dei documenti, la numerazione delle pagine, le date e i flussi di lavoro per presentazioni professionali.
Autenticazione del tuo API Richiesta
Includi il tuo API chiave nella richiesta di autenticazione con il PDF4me REST API.
Caratteristiche principali
- Contenuto di testo personalizzato: Aggiungi qualsiasi testo come intestazione o piè di pagina su Excel Documenti
- Personalizzazione dei caratteri: Controlla la famiglia di caratteri, la dimensione, il colore e i nomi specifici dei caratteri
- Controllo della trasparenzaImposta il testo come semitrasparente (opacità 50%) o completamente opaco (100%).
- Rotazione e orientamento: Applica angoli di rotazione o orientamenti preimpostati (orizzontale, verticale, diagonale, capovolto)
- Supporto culturale: Specificare i codici cultura per una corretta visualizzazione e formattazione del testo
REST API Punto finale
- Metodo: POST
- Punto finale:
office/ApiV2Excel/ExcelAddTextHeaderFooter
REST API Parametri
Importante: I parametri contrassegnati da un asterisco (*) sono obbligatori. Tutte le richieste utilizzano documento, docContente un oggetto azione. I parametri specifici dell'operazione sono proprietà di addTextHeaderFooterToExcelAction.
Parametri richiesti (livello radice)
| Parametro | Tipo | Descrizione | Esempio |
|---|---|---|---|
| documento* | Object | Riferimento al documento. Deve contenere Nome (corda): Excel nome del file con estensione .xlsx o .xls | { "Name": "data.xlsx" } |
| docContent* | String Base64) | Excel contenuto del documento codificato in Base64 | UEsDBBQABgAIAAAA... |
| addTextHeaderFooterToExcelAction* | Object | Configurazione dell'azione. Deve contenere almeno filigranaTesto (stringa): testo da visualizzare come intestazione o piè di pagina | Vedi l'esempio di payload qui sotto |
Parametri opzionali (all'interno di addTextHeaderFooterToExcelAction)
| Parametro | Tipo | Descrizione | Esempio |
|---|---|---|---|
| fontFamily | String | Nome della famiglia di caratteri (ad esempio, Arial, Times New Roman). Predefinito: Arial | Arial |
| dimensione del carattere | Numero | Dimensione del carattere in punti (8-72). Predefinito: 72 | 12 |
| fontColor | String | Codice colore esadecimale o nome del colore. Predefinito: nero | #0000FF |
| semitrasparente | Boolean | vero = opacità 50%, falso = 100% (impostazione predefinita) | false |
| rotazione | Numero | Angolo di rotazione in gradi (0-360). Valore predefinito: 0 | 45 |
| nome del carattere | String | Nome specifico del carattere (sovrascrive fontFamily) | Arial Bold |
| orientamento | String | Orizzontale, Verticale, Diagonale, O CapovoltoHa la priorità sulla rotazione | Horizontal |
| Nome della cultura | String | Codice cultura per la visualizzazione del testo (ad esempio, "en-US", "de-DE") | en-US |
Produzione
IL API restituisce il Excel documento come Base64-stringa codificata in JSON formato.
- Success Response
- Error Responses
Codice di stato: 200 OK
Corpo della risposta:
{
"document": "UEsDBBQABgAIAAAA...",
"fileName": "data.xlsx",
"success": true,
"errorMessage": null
}
400 Bad Request: Parametri non validi, campi obbligatori mancanti, non valido Base64 o documento. 401 Unauthorized: Non valido o mancante API chiave. 500 Internal Server Error: Errore di elaborazione lato server.
Esempio di richiesta
Intestazione
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Carico utile (base)
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"addTextHeaderFooterToExcelAction": {
"watermarkText": "Confidential Report 2024"
}
}
Carico utile (con formattazione opzionale)
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"addTextHeaderFooterToExcelAction": {
"watermarkText": "Confidential Report 2024",
"fontFamily": "Arial",
"fontSize": 12,
"fontColor": "#0000FF",
"orientation": "Horizontal"
}
}
Esempi di codice
- GitHub