Dokumen Aman - Excel API
PDF4me Amankan Excel memungkinkan Anda untuk menerapkan perlindungan kata sandi ke Excel dokumen pada berbagai tingkatan. Ini API Layanan ini mendukung enkripsi file (kata sandi untuk membuka), perlindungan struktur buku kerja (mencegah modifikasi lembar kerja), dan perlindungan konten lembar kerja (mencegah pengeditan sel), dengan hierarki kata sandi dan jenis perlindungan yang fleksibel (Konten, Objek, Skenario, Semua). API menerima Excel konten dokumen melalui REST API panggilan, memanfaatkan Base64 Pengkodean untuk transmisi yang aman. Solusi ini ideal untuk perlindungan data rahasia, keamanan templat, dan alur kerja akses terkontrol.
Memverifikasi Identitas Anda API Meminta
Sertakan milik Anda API masukkan kunci dalam permintaan untuk melakukan otentikasi dengan PDF4me REST API.
Fitur Utama
- Tiga Tingkat Perlindungan: Enkripsi berkas, struktur buku kerja, isi lembar kerja
- Kata Sandi IndependenGunakan kata sandi yang berbeda untuk setiap tingkat perlindungan.
- Kata Sandi CadanganGunakan kata sandi utama sebagai cadangan jika kata sandi khusus level tidak diberikan.
- Pemilihan Lembar Kerja yang FleksibelLindungi lembar kerja tertentu atau semua lembar kerja.
- Opsi Jenis Perlindungan: Isi, Objek, Skenario, atau Semua (komprehensif)
- Pengindeksan Berbasis 0Indeks lembar kerja menggunakan penomoran berbasis 0 (0 = lembar kerja pertama)
REST API Titik akhir
- Metode: POST
- Titik akhir:
office/ApiV2Excel/ExcelSecure
REST API Parameter
Penting: Parameter yang ditandai dengan tanda bintang (*) wajib diisi. Semua permintaan menggunakan dokumen, Konten dokumen, Dan secureExcelActionParameter khusus operasi (kata sandi, protectWorkbook, 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... |
| secureExcelAction* | Object | Konfigurasi tindakan (kata sandi, tingkat perlindungan, pemilihan lembar kerja) | Lihat contoh Payload di bawah ini. |
Parameter Opsional (di dalam secureExcelAction)
| Parameter | Jenis | Keterangan | Contoh |
|---|---|---|---|
| kata sandi | String | Kata sandi enkripsi file (Level 1). Juga digunakan sebagai cadangan untuk perlindungan buku kerja/lembar kerja jika kata sandinya kosong. | MyPassword123 |
| ProtectWorkbook | Boolean | Aktifkan perlindungan struktur buku kerja (Level 2). Default: false | true |
| Lindungi Kata Sandi Buku Kerja | String | Kata sandi perlindungan buku kerja. Alternatif: kata sandi jika kosong. | StructurePass |
| Lindungi Lembar Kerja | Boolean | Aktifkan perlindungan konten lembar kerja (Level 3). Default: false | true |
| Lembar kerjaJenis Perlindungan | String | Isi, Benda-benda, Skenario, atau SemuaDefault: Semua | All |
| Lembar Kerja Perlindungan Kata Sandi | String | Kata sandi perlindungan lembar kerja. Alternatif: kata sandi jika kosong. | EditPass |
| nama lembar kerja | String | Nama lembar kerja dipisahkan koma untuk perlindungan; kosong = semua | Sheet1,Summary |
| Indeks lembar kerja | String | Indeks lembar kerja yang dipisahkan koma (berbasis 0); kosong = semua | 0,2 |
| nama budaya | String | Kode budaya untuk pemrosesan | en-US |
Keluaran
Yang API mengembalikan yang dilindungi kata sandi 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...",
"secureExcelAction": {
"password": "MyPassword123",
"protectWorkbook": true,
"protectWorksheets": true
}
}