Dönüştürme

Metadata API, tek bir HTTP isteği ile elektronik tablo dosyası metadata'sı üzerinde tam kontrol sağlayan, amaca yönelik, geliştirici dostu bir hizmettir. Excel (.xlsx, .xls) gibi klasik ofis biçimleri, CSV (.csv) ve TSV (.tsv) gibi basit ayrılmış dosyalar ya da Apple Numbers (.numbers) belgeleri ile çalışıyor olun, API dosya ayrıştırmanın karmaşıklığını ortadan kaldırır ve anahtar tanımlayıcı özellikleri milisaniyeler içinde okumanıza, eklemenize ya da değiştirmenize olanak tanır. Binlerce raporu, araştırma veri setini veya finansal tabloyu toplu işleyebildiğinizi ve her dosyayı yazar bilgisi, başlık, konu, açıklama, anahtar kelime listeleri ve uygulamanızın tanımladığı özel etiket koleksiyonları gibi tutarlı bir setle zenginleştirebildiğinizi hayal edin. Bu otomasyon seviyesi, sayısız saat manuel düzenleme tasarrufu sağlamakla kalmaz, aynı zamanda müşterilere, iş ortaklarına ya da arşiv sistemlerine gönderdiğiniz her dosyanın, indeksleme, uyumluluk ve keşfedilebilirlik için ihtiyaç duyduğunuz kesin metadata'ya sahip olmasını garanti eder. Servis, ham dosya baytlarını ya da bulutta barındırılan bir belgeye işaret eden bir URL'yi kabul eder, ardından istenen metadata değişiklikleri uygulanmış yeni, tamamen oluşmuş bir dosyayı, orijinal veri düzeni ya da formüllerine dokunmadan geri döndürür.

Ana Özellikler

API durum bilgisiz (stateless) olduğu için CI/CD boru hatlarına, sunucu tarafı toplu işlere ya da istemci tarafı JavaScript widget'larına kolayca entegre edilebilir; bu, bir web uygulamasından her dışa aktarımın veya periyodik yedeklemenin doğru kaynak bilgilerini içerdiğini garanti eder. Güvenlik yerleşiktir: tüm çağrılar TLS üzerinden yapılır, yükler uçtan uca şifrelenir ve API, API‑key ya da OAuth 2.0 kimlik doğrulamasını destekleyerek erişimi yalnızca güvenilir hizmetlerle sınırlandırmanıza olanak tanır. Temel motor, her desteklenen format için yüksek derecede optimize edilmiş ayrıştırma kütüphanelerinden yararlanır; bu sayede yüzlerce çalışma sayfasına sahip devasa Excel çalışma kitapları bile hızlıca işlenir; tipik isteklerin çoğu 200 ms’nin altında tamamlanır. Pratikte, ürününüz içinde sorunsuz bir “Metadata Ekle” düğmesi oluşturabilir, dosyayı servise gönderebilir, zenginleştirilmiş sürümü alıp anında indirme seçeneği sunabilirsiniz; kullanıcı arayüzünden hiç çıkmaz. API ayrıca ayrıntılı işlem günlükleri döndürür, böylece geliştiriciler programlı olarak beklenen alanların güncellenip güncellenmediğini doğrulayabilir, gerektiğinde değişiklikleri geri alabilir veya özel etiket değerlerine dayalı olarak ek işleme adımları tetikleyebilir. Tek tip, dil bağımsız bir REST uç noktası sağlayarak, Metadata API geliştiricilerin birden çok format‑spesifik kütüphane sürdürme ihtiyacını ortadan kaldırır, bakım yükünü azaltır ve yeni elektronik tablo standartları ortaya çıktıkça geleceğe dönük uyumluluğu temin eder. SaaS satıcısı olarak lisans bilgilerini gömmek, araştırma kurumları veri setlerini kataloglamak ya da bir işletme belge uyumluluğunu otomatikleştirmek isterken, bu API tek bir basit çağrı ile dosyalarınızı hızlı, güvenli ve ölçeklenebilir bir şekilde zenginleştirmenizi sağlar.

Belgeler

Parametreler

AppRequest.Metadata: PropertyName ve PropertyValue ile
AppRequest.MetadataJson: Metadata yapısını kullanmıyorsanız json veri tipini kullanmalısınız.
UploadFileRequest.OperationId: Bunlar, online hizmetlerimize yüklemeniz gereken dosyalardır; verileri kendi yolunuzla hazırlayabilirsiniz ancak html dosya girişi standardına uymalıdır.
UploadFileRequest.Files: Bunlar, online hizmetlerimize yüklemeniz gereken dosyalardır; verileri kendi yolunuzla hazırlayabilirsiniz ancak html dosya girişi standardına uymalıdır.

Uç Noktayı Kullan

Dosyaları ve erişim tokenını içeren bir istek gönderin 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'
Servis, işlenmiş dosya için bir indirme URL'siyle yanıt verecektir, bu örnekte:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Dosya adını ve klasör adını içeren bir istek gönderin Download API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
Dosyayı alacaksınız ve ya kullanabilir ya da iş akışınızın bir sonraki adımına yönlendirebilirsiniz.