Tambahkan Teks Header Footer - Excel API
PDF4me Tambahkan Teks Header Footer memungkinkan Anda menambahkan header dan footer teks yang dapat disesuaikan ke Excel dokumen dengan kontrol format yang komprehensif. Ini API proses layanan Excel File ini menambahkan teks ke bagian header atau footer dengan pengaturan gaya font (jenis, ukuran, warna), tingkat transparansi, sudut rotasi, dan opsi orientasi (horizontal, vertikal, diagonal, terbalik). API menerima Excel konten dokumen melalui REST API panggilan, memanfaatkan Base64 Pengkodean untuk transmisi yang aman. Solusi ini ideal untuk branding dokumen, nomor halaman, tanggal, dan alur kerja presentasi profesional.
Memverifikasi Identitas Anda API Meminta
Sertakan milik Anda API masukkan kunci dalam permintaan untuk melakukan otentikasi dengan PDF4me REST API.
Fitur Utama
- Konten Teks KustomTambahkan teks apa pun sebagai header atau footer pada Excel dokumen
- Kustomisasi Font: Mengontrol jenis huruf, ukuran, warna, dan nama huruf tertentu
- Kontrol Transparansi: Atur teks menjadi semi-transparan (opasitas 50%) atau sepenuhnya buram (100%)
- Rotasi & Orientasi: Terapkan sudut rotasi atau orientasi yang telah ditentukan sebelumnya (horizontal, vertikal, diagonal, terbalik)
- Dukungan BudayaTentukan kode budaya untuk rendering dan pemformatan teks yang tepat.
REST API Titik akhir
- Metode: POST
- Titik akhir:
office/ApiV2Excel/ExcelAddTextHeaderFooter
REST API Parameter
Penting: Parameter yang ditandai dengan tanda bintang (*) wajib diisi. Semua permintaan menggunakan dokumen, Konten dokumen, dan satu objek aksi. Parameter spesifik operasi adalah properti dari tambahkanHeaderFooterTeksKeExcelAction.
Parameter yang Diperlukan (tingkat akar)
| Parameter | Jenis | Keterangan | Contoh |
|---|---|---|---|
| dokumen* | Object | Referensi dokumen. Harus memuat Nama (rangkaian): Excel nama file dengan ekstensi .xlsx atau .xls | { "Name": "data.xlsx" } |
| Konten dokumen* | String (Base64) | Excel isi dokumen yang dikodekan dalam Base64 | UEsDBBQABgAIAAAA... |
| tambahkanHeaderFooterTeksKeExcelAction* | Object | Konfigurasi tindakan. Harus berisi setidaknya Teks tanda air (string): teks yang akan ditampilkan sebagai header atau footer | Lihat contoh Payload di bawah ini. |
Parameter Opsional (di dalam addTextHeaderFooterToExcelAction)
| Parameter | Jenis | Keterangan | Contoh |
|---|---|---|---|
| Keluarga font | String | Nama keluarga font (misalnya, Arial, Times New Roman). Default: Arial | Arial |
| Ukuran huruf | Nomor | Ukuran font dalam poin (8-72). Default: 72 | 12 |
| warna huruf | String | Kode warna heksadesimal atau nama warna. Default: hitam | #0000FF |
| setengah tembus terang | Boolean | true = opasitas 50%, false = 100% (default) | false |
| rotasi | Nomor | Sudut rotasi dalam derajat (0-360). Nilai default: 0 | 45 |
| nama font | String | Nama font spesifik (menggantikan fontFamily) | Arial Bold |
| orientasi | String | Horisontal, Vertikal, Diagonal, atau Terbalik. Mendahului rotasi | Horizontal |
| nama budaya | String | Kode budaya untuk rendering teks (misalnya, "en-US", "de-DE") | en-US |
Keluaran
Yang API mengembalikan Excel dokumen sebagai Base64-string yang dikodekan dalam JSON format.
- Success Response
- Error Responses
Kode Status: 200 OK
Isi Tanggapan:
{
"document": "UEsDBBQABgAIAAAA...",
"fileName": "data.xlsx",
"success": true,
"errorMessage": null
}
400 Bad RequestParameter tidak valid, kolom wajib hilang, tidak valid Base64 atau dokumen. 401 Unauthorized: Tidak valid atau hilang API kunci. 500 Internal Server Error: Kesalahan pemrosesan di sisi server.
Contoh Permintaan
Judul
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Muatan (Dasar)
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"addTextHeaderFooterToExcelAction": {
"watermarkText": "Confidential Report 2024"
}
}
Muatan (Dengan format opsional)
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"addTextHeaderFooterToExcelAction": {
"watermarkText": "Confidential Report 2024",
"fontFamily": "Arial",
"fontSize": 12,
"fontColor": "#0000FF",
"orientation": "Horizontal"
}
}
Contoh Kode
- GitHub