Zum Hauptinhalt springen
PDF4me APIIntegrationenWissensdatenbankErweiterungenAPI-TesterBlog

Text hinzufügen Kopf- und Fußzeile - Excel API

PDF4me Text hinzufügen Kopf-Fußzeile ermöglicht es Ihnen, anpassbare Textkopf- und -fußzeilen hinzuzufügen Excel Dokumente mit umfassender Formatierungskontrolle. Dies API Serviceprozesse Excel Dateien und fügt Text zu Kopf- oder Fußzeilen mit Schriftart (Familie, Größe, Farbe), Transparenzstufen, Drehwinkeln und Ausrichtungsoptionen (horizontal, vertikal, diagonal, auf dem Kopf stehend) hinzu. API empfängt Excel Dokumentinhalt durch REST API Anrufe, die genutzt werden Base64 Verschlüsselung für sichere Übertragung. Diese Lösung eignet sich ideal für Dokumentenbranding, Seitenzahlen, Datumsangaben und professionelle Präsentationsabläufe.

Verwandte Blog-Beiträge
Zu dieser Funktion gibt es noch keinen Blogbeitrag – folgt in Kürze.
Schauen Sie sich in der Zwischenzeit im PDF4me-Blog Tutorials und Arbeitsabläufe für alle Plattformen an.
Besuchen Sie den Blog →

Authentifizierung Ihres API Anfrage​

Fügen Sie Ihre API Geben Sie den Schlüssel in der Anfrage ein, um sich mit dem zu authentifizieren. PDF4me REST APIDie

Get your api Key

Hauptmerkmale​

  • Benutzerdefinierter TextinhaltFügen Sie beliebigen Text als Kopf- oder Fußzeile hinzu auf Excel Dokumente
  • Schriftartanpassung: Schriftart, Größe, Farbe und spezifische Schriftnamen steuern
  • Transparenzkontrolle: Halbtransparenten (50 % Deckkraft) oder vollständig deckenden (100 %) Text einstellen
  • Rotation und Orientierung: Drehwinkel oder voreingestellte Ausrichtungen anwenden (horizontal, vertikal, diagonal, auf dem Kopf stehend)
  • Kulturförderung: Kulturcodes für die korrekte Textwiedergabe und -formatierung angeben

REST API Endpunkt​

  • Verfahren: POST
  • Endpunkt: office/ApiV2Excel/ExcelAddTextHeaderFooter

REST API Parameter​

Wichtig: Mit einem Sternchen (*) gekennzeichnete Parameter sind erforderlich. Alle Anfragen verwenden dokumentieren, docContentund einem Aktionsobjekt. Operationsspezifische Parameter sind Eigenschaften von addTextHeaderFooterToExcelActionDie

Erforderliche Parameter (Stammebene)​

ParameterTypBeschreibungBeispiel
dokumentieren*ObjectDokumentenreferenz. Muss enthalten Name (Zeichenkette): Excel Dateiname mit der Erweiterung .xlsx oder .xls{ "Name": "data.xlsx" }
docContent*String (Base64)Excel Dokumentinhalt kodiert in Base64UEsDBBQABgAIAAAA...
addTextHeaderFooterToExcelAction*ObjectAktionskonfiguration. Muss mindestens Folgendes enthalten: WasserzeichenText (Zeichenkette): Text, der als Kopf- oder Fußzeile angezeigt werden sollSiehe untenstehendes Nutzlastbeispiel.

Optionale Parameter (innerhalb von addTextHeaderFooterToExcelAction)​

ParameterTypBeschreibungBeispiel
SchriftartStringName der Schriftart (z. B. Arial, Times New Roman). Standard: ArialArial
SchriftgrößeNummerSchriftgröße in Punkt (8–72). Standard: 7212
SchriftfarbeStringHexadezimaler Farbcode oder Farbname. Standard: Schwarz#0000FF
halbtransparentBooleantrue = 50 % Deckkraft, false = 100 % (Standard)false
DrehungNummerDrehwinkel in Grad (0–360). Standardwert: 045
SchriftartnameStringSpezifischer Schriftartname (überschreibt Schriftartfamilie)Arial Bold
OrientierungStringHorizontal, Vertikal, Diagonale, oder Verkehrt herumHat Vorrang vor der RotationHorizontal
KulturnameStringKulturcode für die Textdarstellung (z. B. "en-US", "de-DE")en-US

Ausgabe​

Der API gibt zurück Excel Dokument als ein Base64-kodierte Zeichenkette in JSON FormatDie

Statuscode: 200 OK

Antworttext:

{
"document": "UEsDBBQABgAIAAAA...",
"fileName": "data.xlsx",
"success": true,
"errorMessage": null
}

Beispielanfrage​

Kopfzeile​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Nutzlast (Basis)​

{
 "document": { "Name": "data.xlsx" },
 "docContent": "UEsDBBQABgAIAAAA...",
 "addTextHeaderFooterToExcelAction": {
 "watermarkText": "Confidential Report 2024"
 }
}

Nutzdaten (mit optionaler Formatierung)​

{
 "document": { "Name": "data.xlsx" },
 "docContent": "UEsDBBQABgAIAAAA...",
 "addTextHeaderFooterToExcelAction": {
 "watermarkText": "Confidential Report 2024",
 "fontFamily": "Arial",
 "fontSize": 12,
 "fontColor": "#0000FF",
 "orientation": "Horizontal"
 }
}

Codebeispiele​

Hilfe erhalten​

Get Your API KeyAPI SamplesGetting Started