Tambahkan Baris - Excel API
PDF4me Tambahkan Baris memungkinkan Anda untuk memasukkan JSON data sebagai baris ke dalam Excel dokumen dengan mode penyisipan berbasis tabel atau berbasis koordinat. Ini API Layanan ini mendukung konversi tipe otomatis (string ke angka/tanggal), penguraian khusus budaya, pemformatan tanggal dan angka yang dapat disesuaikan, dan penanganan nilai null. API menerima Excel isi dokumen dan JSON data melalui REST API panggilan, memanfaatkan Base64 Pengkodean untuk transmisi yang aman. Solusi ini ideal untuk pengisian data otomatis, pembuatan laporan, dan alur kerja basis data ke Excel.
Memverifikasi Identitas Anda API Meminta
Sertakan milik Anda API masukkan kunci dalam permintaan untuk melakukan otentikasi dengan PDF4me REST API.
Fitur Utama
- Mode Penyisipan Ganda: Berbasis tabel (pencocokan header) atau berbasis koordinat (penentuan posisi baris/kolom yang tepat)
- JSON Dukungan DataMasukkan objek tunggal atau larik objek sebagai Excel baris
- Konversi Tipe Otomatis: Mengubah JSON tali ke Excel angka dan tanggal
- Kustomisasi Format: Terapkan pola pemformatan tanggal dan angka khusus
- Dukungan Budaya: Menguraikan tanggal dan angka sesuai dengan kode budaya yang ditentukan
- Penanganan Nilai NullLewati nilai null atau masukkan sebagai sel kosong
REST API Titik akhir
- Metode: POST
- Titik akhir:
office/ApiV2Excel/ExcelAddRows
REST API Parameter
Penting: Parameter yang ditandai dengan tanda bintang (*) wajib diisi. Semua permintaan menggunakan dokumen, Konten dokumen, Dan tambahkanBarisKeExcelAksiParameter khusus operasi (jsonInput, worksheetName, dll.) adalah properti dari objek aksi.
Parameter yang Diperlukan (tingkat akar)
| Parameter | Jenis | Keterangan | Contoh |
|---|---|---|---|
| dokumen* | Object | Referensi dokumen dengan Nama (Excel nama file) | { "Name": "data.xlsx" } |
| Konten dokumen* | String (Base64) | Excel isi dokumen yang dikodekan dalam Base64 | UEsDBBQABgAIAAAA... |
| tambahkanBarisKeExcelAksi* | Object | Konfigurasi tindakan. Harus berisi input json (rangkaian): JSON data sebagai larik objek atau objek tunggal | Lihat contoh Payload di bawah ini. |
Parameter Opsional (di dalam addRowsToExcelAction)
| Parameter | Jenis | Keterangan | Contoh |
|---|---|---|---|
| Nama lembar kerja | String | Nama lembar kerja target. Default: "Sheet1" | Sheet1 |
| nama tabel | String | Excel nama tabel untuk mode berbasis tabel; kosong = mode berbasis koordinat | SalesTable |
| excelRowNumber | Angka (integer) | Posisi berbasis 1 di dalam tabel (hanya mode tabel) | 5 |
| sisipkanDariBaris | Angka (integer) | Baris awal berbasis 1 (hanya mode koordinat) | 10 |
| sisipkanDariKolom | Angka (integer) | kolom awal berbasis 1 (hanya mode koordinat) | 3 |
| konversiNumericAndDate | Boolean | Konversi tipe otomatis. Default: true | true |
| Format tanggal | String | Excel Pola format tanggal. Default: "yyyy-MM-dd" | MM/dd/yyyy |
| Format numerik | String | Excel Pola format numerik. Default: "N2" | #,##0.00 |
| abaikan nilai null | Boolean | Lewati nilai null. Default: false | false |
| abaikanJudulAtribut | Boolean | Pencocokan header tanpa memperhatikan huruf besar/kecil. Default: false | true |
| nama budaya | String | Pengaturan budaya untuk penguraian tanggal/angka. Default: "en-US" | en-US |
Keluaran
Yang API mengembalikan Excel dokumen sebagai Base64-string yang dikodekan dalam JSON format (dokumen, nama file, sukses, pesan kesalahan).
Contoh Permintaan
Judul
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Muatan (Dasar)
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"addRowsToExcelAction": {
"jsonInput": "[{\"Name\":\"John\",\"Age\":30}]"
}
}