Perbandingan
Selamat datang di pusat dokumentasi resmi untuk Comparison API, solusi yang dirancang khusus untuk mengubah tugas kontrol versi spreadsheet yang sering membosankan menjadi alur kerja yang ramping dan berfokus pada pengembang. Baik Anda seorang analis data yang menyatukan laporan kuartalan, tim keuangan yang melacak revisi anggaran, atau insinyur perangkat lunak yang menyematkan kemampuan diff ke dalam pipeline data yang lebih besar, API ini dirancang untuk menyesuaikan diri dengan kebutuhan Anda dan menghilangkan tebak‑tebakan dalam mengidentifikasi perubahan di berbagai format spreadsheet. Pada intinya, Comparison API menggunakan model yang sederhana namun kuat: Anda menyediakan dua file sumber—baik berasal dari Apple Numbers, ekspor CSV/TSV, atau suite Excel yang umum (.xlsx, .xls)—dan layanan mengembalikan satu file hasil yang menyoroti setiap penambahan, penghapusan, dan modifikasi dengan petunjuk visual yang jelas. Penekanan pada kejelasan bukan sekadar tambahan; setiap perbedaan diberi anotasi yang mencerminkan konvensi spreadsheet asli (latar belakang sel berwarna, balon komentar, dan penanda baris/kolom) sehingga pengguna akhir dapat membuka hasilnya di aplikasi pilihan mereka dan langsung memahami apa yang berubah. Selain diff dasar, API juga mempertahankan format asli, formula, dan tipe data, memastikan output bukan sekadar laporan teks biasa melainkan workbook yang sepenuhnya berfungsi dan siap untuk analisis atau distribusi lebih lanjut. Keamanan dan kinerja diintegrasikan pada setiap permintaan: semua transfer file menggunakan TLS 1.3, file diproses dalam kontainer terisolasi dengan batas memori yang ketat, dan hasil biasanya dikembalikan dalam kurang dari satu detik untuk file hingga 10 MB, serta dapat skala dengan mulus untuk dataset yang lebih besar melalui streaming terpotong. Dokumentasi yang Anda baca saat ini disusun untuk memungkinkan Anda memulai dalam hitungan menit—dimulai dengan otentikasi, berlanjut ke konstruksi permintaan, dan berakhir dengan pola praktik terbaik untuk penanganan kesalahan, paginasi, dan integrasi webhook. Sepanjang dokumen, Anda akan menemukan contoh kode dalam Python, JavaScript, Java, dan C#, yang memperlihatkan bagaimana satu baris kode dapat memicu perbandingan lengkap, serta lingkungan sandbox tempat Anda dapat mencoba file nyata tanpa meninggalkan browser. Pada akhir panduan ini, Anda akan memiliki pemahaman yang kuat tentang cara menyematkan perbandingan spreadsheet yang andal dan berkualitas tinggi ke dalam alur kerja apa pun, mengurangi waktu tinjauan manual, dan memberdayakan pemangku kepentingan dengan log perubahan yang transparan dan dapat diaudit—semua sambil memanfaatkan API yang aman, cepat, dan mudah digunakan.
Fitur Utama
API Perbandingan menawarkan seperangkat fitur yang luas yang mengatasi masalah umum yang dihadapi saat menyelaraskan data spreadsheet di berbagai platform. Pertama dan terutama, API mendukung daftar format file yang komprehensif: Apple Numbers (.numbers), file teks delimited (CSV, TSV), Excel lama (.xls), dan Excel modern (.xlsx). Ini menghilangkan kebutuhan akan alat pra‑konversi, memungkinkan Anda memasukkan file asli langsung ke layanan. Mesin diff beroperasi pada tingkat sel, mendeteksi perubahan nilai, formula, bahkan atribut format seperti gaya font, shading sel, dan aturan validasi data; setiap variasi ditandai dengan jelas dalam workbook hasil menggunakan skema warna yang dapat disesuaikan, memudahkan reviewer non‑teknis untuk menafsirkan output. Untuk kumpulan data berskala besar, API menawarkan mode perbandingan inkremental, memungkinkan Anda membandingkan hanya baris yang ditambahkan atau dimodifikasi sejak baseline sebelumnya, sehingga mengurangi waktu proses dan bandwidth jaringan. Selain itu, Anda dapat meminta ringkasan JSON terstruktur dari perubahan selain file diff visual, memungkinkan otomatisasi downstream seperti memicu peringatan, memperbarui dasbor, atau memasukkan perubahan ke sistem kontrol versi. Fitur keamanan mencakup otentikasi token bearer OAuth 2.0, kunci API berskala, dan opsi whitelist IP, sementara data yang disimpan terenkripsi dengan AES‑256. Layanan juga mematuhi standar kepatuhan GDPR dan CCPA, memberi Anda kepercayaan saat menangani informasi pribadi atau keuangan yang sensitif. Dari segi kinerja, API dirancang untuk latensi rendah; berkat skala horizontal dan algoritma diff dalam memori, sebagian besar perbandingan selesai dalam kurang dari satu detik untuk workbook berukuran standar, dengan dukungan pemrosesan asinkron melalui webhook untuk file yang melebihi 50 MB. Akhirnya, pengalaman pengembang menjadi prioritas utama: spesifikasi OpenAPI yang komprehensif, SDK yang dihasilkan secara otomatis, kode kesalahan yang detail, dan header limit kecepatan real‑time memungkinkan Anda mengintegrasikan API dengan gesekan minimal, sementara konsol sandbox dan repositori contoh yang luas menampilkan implementasi praktik terbaik untuk pemrosesan batch, pipeline CI/CD, dan fungsi serverless. singkatnya, API Perbandingan memberikan kemampuan diff spreadsheet yang cepat, aman, dan ramah pengembang yang memungkinkan Anda menemukan perubahan dengan satu panggilan sederhana—tanpa mempedulikan format, ukuran, atau kompleksitas data yang Anda tangani.
Dokumen
Parameter
- format: Format file output yang didukung.
- UploadFileRequest.OperationId: Ini adalah ID operasi
- UploadFileRequest.Files: Ini adalah file yang perlu 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 Perbandingan
curl -X 'POST' \ 'https://api.sheetize.cloud/comparison/to-xlsx' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.Files=@TheFileOne.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' \ -F 'UploadFileRequest.Files=@TheFileTwo.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' -
Layanan akan merespons dengan URL unduhan untuk file yang diproses, dalam contoh ini:
{ "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 dan dapat menggunakannya atau cukup meneruskannya ke langkah selanjutnya dalam alur kerja Anda.
