Compress
Selamat datang di dokumentasi resmi untuk Compress, API yang ringan namun kuat yang dirancang untuk mengurangi ukuran file spreadsheet menjadi sebagian kecil dari ukuran aslinya dengan satu permintaan yang intuitif. Di dunia yang digerakkan oleh data saat ini, tim terus-menerus bertukar spreadsheet yang berisi segala hal mulai dari daftar sederhana hingga model keuangan yang kompleks, dan volume besar file tersebut dengan cepat menjadi biaya tersembunyi—upload yang lebih lambat, biaya penyimpanan yang meningkat, dan waktu pemrosesan yang lebih lama untuk sistem hilir. Compress mengatasi masalah ini dengan menawarkan layanan cloud‑native yang secara cerdas menganalisis struktur internal spreadsheet Anda, menghilangkan beban yang tidak perlu, dan mengemas ulang konten dalam bentuk yang dioptimalkan dan kompak tanpa mengorbankan integritas atau keterbacaan data. Halaman dokumentasi ini berfungsi sebagai satu sumber kebenaran, membimbing Anda melalui semua yang perlu diketahui untuk mulai menggunakan API secara efektif, mulai dari autentikasi dan format permintaan hingga penanganan error dan strategi praktik terbaik untuk pemrosesan batch. Baik Anda seorang insinyur backend berpengalaman yang mengintegrasikan pipeline data, pengembang front‑end yang ingin meningkatkan pengalaman pengguna saat mengunggah file, atau manajer TI yang ditugaskan mengurangi beban penyimpanan di seluruh organisasi, panduan ini akan memberikan instruksi langkah‑demi‑langkah yang jelas, contoh kode dalam berbagai bahasa, dan contoh dunia nyata yang menunjukkan cara mencapai hasil kompresi terbaik untuk beragam format spreadsheet. Sepanjang dokumentasi Anda akan menemukan bagian khusus tentang pertimbangan keamanan—seperti enkripsi TLS, token JWT yang ditandatangani, dan penanganan data yang sesuai GDPR—serta benchmark kinerja yang menunjukkan latensi dan throughput tipikal di bawah beban kerja berbeda. Kami juga menyertakan FAQ yang luas yang mencakup skenario umum, matriks pemecahan masalah untuk diagnosis cepat, dan tautan ke forum komunitas di mana Anda dapat berbagi wawasan dengan pengembang lain yang menggunakan Compress dalam produksi. Pada akhir panduan ini, Anda seharusnya merasa yakin dalam mengonfigurasi lingkungan, mengirim panggilan API yang tepat, dan menafsirkan payload respons, sehingga Anda dapat menyematkan kompresi secara mulus ke dalam alur kerja yang ada dan mulai melihat penghematan nyata pada biaya penyimpanan serta bandwidth jaringan segera. Selami, jelajahi bagian yang sesuai dengan peran Anda, dan biarkan Compress menangani pekerjaan berat pengurangan data sehingga Anda dapat fokus membangun aplikasi yang lebih kaya dan responsif.
Fitur Utama
Inti dari Compress API berputar di sekitar set fitur lengkap yang membuat pengurangan spreadsheet menjadi mudah dan dapat diandalkan. Pertama dan terutama, layanan mendukung berbagai jenis file—termasuk Apple Numbers, file CSV dan TSV biasa, serta format .xlsx dan .xls Microsoft Excel—sehingga Anda dapat mengirim hampir semua spreadsheet yang Anda temui tanpa memerlukan langkah pra‑konversi. Di balik layar, mesin melakukan optimasi multi‑fase: menormalkan struktur XML atau biner internal file, menghilangkan gaya duplikat, menggabungkan format sel yang identik, menghapus baris dan kolom tersembunyi yang tidak berisi data, serta memampatkan objek tersemat seperti gambar, diagram, dan tabel pivot dengan menerapkan algoritma kompresi lossless yang disesuaikan untuk setiap payload. Selain itu, API mendeteksi dan menghapus metadata, komentar, serta informasi versi yang berlebih yang biasanya memperbesar ukuran file namun jarang memiliki fungsi. Semua operasi ini terjadi secara real‑time, memberikan hasil dalam milidetik untuk file hingga 50 MB, dan skalabel dengan mulus ke dokumen yang lebih besar dengan throttling yang terkelola serta callback kemajuan. Keamanan telah terintegrasi—setiap permintaan ditransfer melalui HTTPS, dan layanan tidak menyimpan salinan file Anda melebihi jendela pemrosesan singkat, memastikan kepatuhan terhadap regulasi privasi yang ketat. Dari perspektif pengembang, API dirancang semudah mungkin: satu POST ke endpoint `/compress` dengan file yang dilampirkan sebagai multipart/form‑data mengembalikan respons JSON yang berisi URL unduhan file baru, ukuran asli dan terkompresi, serta checksum untuk verifikasi. Parameter opsional memungkinkan Anda menyesuaikan tingkat kompresi, mempertahankan lembar tertentu, atau menentukan whitelist objek tersemat tertentu bila Anda perlu mempertahankan kesetiaan penuh untuk aplikasi hilir. SDK lengkap tersedia untuk Python, Node.js, Java, dan Go, masing‑masing menyajikan metode pembungkus ringkas—`compressSpreadsheet(filePath, options)`—yang mengabstraksi lapisan HTTP sepenuhnya. Dokumentasi batas‑rate yang detail dan endpoint bulk‑upload memungkinkan Anda memproses ribuan file per jam tanpa membebani infrastruktur, sementara logika retry bawaan dan penanganan back‑off eksponensial menjaga pipeline tetap kuat menghadapi gangguan jaringan sementara. Singkatnya, Compress API menyediakan solusi cepat, aman, dan ramah pengembang yang mengurangi jejak penyimpanan spreadsheet, mempercepat transfer file, dan menyederhanakan alur kerja manajemen data dengan hanya satu panggilan sederhana.
Dokumen
Parameter
- AppRequest.CompressionLevel: Tingkat kompresi dari satu hingga sembilan (1‑9)
- UploadFileRequest.OperationId: Ini adalah ID operasi
- UploadFileRequest.Files: Ini adalah file yang harus Anda unggah ke layanan online kami, Anda dapat menyiapkan data dengan cara Anda sendiri tetapi harus mengikuti standar input file HTML.
Gunakan Endpoint
-
Kirim permintaan yang menyertakan file dan token akses API Compress
curl -X 'POST' \ 'https://api.sheetize.cloud/compress' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.CompressionLevel=2' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' -
Layanan akan merespons dengan URL unduhan untuk file yang diproses, dalam contoh ini URL-nya adalah:
{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 } -
Kirim permintaan yang menyertakan nama file dan nama folder ke API Unduh
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - Anda akan menerima file tersebut dan dapat menggunakannya atau cukup meneruskannya ke langkah selanjutnya dalam alur kerja Anda.
