Konversi

Metadata API adalah layanan yang dirancang khusus, ramah pengembang, yang memberikan kontrol penuh atas metadata file spreadsheet langsung di tangan Anda dengan hanya satu permintaan HTTP. Baik Anda bekerja dengan format kantor klasik seperti Excel (.xlsx, .xls), file delimited sederhana seperti CSV (.csv) dan TSV (.tsv), atau bahkan dokumen Apple Numbers (.numbers), API menyederhanakan kompleksitas parsing file dan memungkinkan Anda membaca, menambah, atau memodifikasi properti deskriptif utama dalam hitungan milidetik. Bayangkan dapat memproses ribuan laporan, kumpulan data riset, atau laporan keuangan secara batch, memperkaya setiap file dengan serangkaian informasi penulis, judul, subjek, deskripsi, daftar kata kunci, dan bahkan koleksi tag khusus yang didefinisikan oleh aplikasi Anda sendiri. Tingkat otomasi ini tidak hanya menghemat jam‑jam kerja manual yang tak terhitung, tetapi juga menjamin setiap file yang Anda kirim ke klien, kolaborator, atau sistem arsip membawa metadata tepat yang Anda perlukan untuk pengindeksan, kepatuhan, dan ketertemuan. Layanan ini bekerja dengan menerima byte file mentah atau URL yang mengarah ke dokumen yang dihosting di cloud, kemudian mengembalikan file baru yang telah sepenuhnya dibentuk dengan perubahan metadata yang diminta tanpa mengubah tata letak data atau formula asli.

Fitur Utama

Karena API bersifat stateless, Anda dapat dengan mudah mengintegrasikannya ke dalam pipeline CI/CD, pekerjaan batch sisi server, atau widget JavaScript sisi klien, memastikan setiap ekspor dari aplikasi web atau setiap cadangan periodik berisi informasi asal yang tepat. Keamanan sudah terintegrasi: semua panggilan dilakukan melalui TLS, muatan dienkripsi end‑to‑end, dan API mendukung otentikasi API‑key atau OAuth 2.0, memungkinkan Anda membatasi akses hanya ke layanan tepercaya. Mesin dasar memanfaatkan pustaka parsing yang sangat dioptimalkan untuk setiap format yang didukung, menjamin bahkan workbook Excel besar dengan ratusan lembar kerja diproses dengan cepat; sebagian besar permintaan umum selesai dalam kurang dari 200 ms. Dalam praktiknya, ini berarti Anda dapat membangun tombol "Tambah Metadata" yang mulus di dalam produk Anda yang mengirim file ke layanan, menerima versi yang diperkaya, dan menawarkan unduhan segera—semua tanpa pengguna meninggalkan antarmuka. API juga mengembalikan log operasi terperinci, sehingga pengembang dapat secara programatis memverifikasi bahwa bidang yang diharapkan telah diperbarui, mengembalikan perubahan bila diperlukan, atau memicu langkah pemrosesan lanjutan berdasarkan nilai tag khusus. Dengan menyediakan endpoint REST yang seragam dan bebas bahasa, Metadata API menghilangkan kebutuhan pengembang untuk memelihara banyak pustaka spesifik format, mengurangi beban pemeliharaan, dan memastikan kompatibilitas masa depan saat standar spreadsheet baru muncul. Baik Anda adalah vendor SaaS yang ingin menyematkan informasi lisensi, institusi riset yang mengkatalogkan kumpulan data, atau perusahaan yang mengotomatisasi kepatuhan dokumen, API ini menawarkan cara yang cepat, aman, dan skalabel untuk memperkaya file Anda dengan satu panggilan sederhana.

Dokumen

Parameter

AppRequest.Metadata: Dengan PropertyName dan PropertyValue
AppRequest.MetadataJson: Jika Anda tidak menggunakan struktur Metadata, maka Anda harus menggunakan tipe data json.
UploadFileRequest.OperationId: Ini adalah file yang perlu Anda unggah ke layanan online kami, Anda dapat menyiapkan data dengan cara Anda sendiri namun harus mengikuti standar input file html.
UploadFileRequest.Files: Ini adalah file yang perlu Anda unggah ke layanan online kami, Anda dapat menyiapkan data dengan cara Anda sendiri namun harus mengikuti standar input file html.

Gunakan Endpoint

Kirim permintaan yang menyertakan file dan token akses Metadata API

curl -X 'POST' \ 'https://api.sheetize.cloud/metadata' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.Metadata={"propertyName":"string","propertyValue":"string"}' \ -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 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 Download API

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 berikutnya dalam alur kerja Anda.