Karşılaştırma

Karşılaştırma API'sinin resmi dokümantasyon merkezi'ne hoş geldiniz; bu amaçla geliştirilmiş çözüm, hesap tablosu sürüm kontrolünün genellikle sıkıcı görevini akıcı, geliştirici odaklı bir iş akışına dönüştürür. İster çeyrek raporlarını uzlaştıran bir veri analisti, bütçe revizyonlarını takip eden bir finans ekibi ya da daha büyük bir veri hattına diff yeteneklerini entegre eden bir yazılım mühendisi olun, bu API sizin bulunduğunuz noktada size uyacak şekilde tasarlanmıştır ve çeşitli hesap tablosu formatları arasındaki değişiklikleri bulmayı tahmin işine bırakmaz. Temelde, Karşılaştırma API'si basit ama güçlü bir model izler: iki kaynak dosya sağlarsınız—Apple Numbers, CSV/TSV dışa aktarımı ya da yaygın Excel (.xlsx, .xls) paketi olsun—ve hizmet, her ekleme, silme ve değişikliği kristal netliğinde görsel ipuçlarıyla vurgulayan tek bir sonuç dosyası döndürür. Netliğe verilen önem bir sonradan düşünülmüş değildir; her farklılık, yerel hesap tablosu geleneklerini (renk kodlu hücre arka planları, yorum balonları ve satır/sütun işaretçileri) yansıtan bir şekilde eklenir, böylece son kullanıcılar sonucu tercih ettikleri uygulamada açıp neyin değiştiğini anında anlayabilir. Temel diff'in ötesinde, API ayrıca orijinal biçimlendirmeyi, formülleri ve veri tiplerini korur; böylece çıktı yalnızca düz metin bir rapor olmayıp, daha fazla analiz ya da dağıtım için tamamen işlevsel bir çalışma kitabı olur. Güvenlik ve performans her istekte yer alır: tüm dosya transferleri TLS 1.3 üzerinden gerçekleşir, dosyalar izole konteynerlerde sıkı bellek limitleriyle işlenir ve sonuçlar genellikle 10 MB'a kadar dosyalar için bir saniyenin altında döndürülür; daha büyük veri setleri için parçalı akışla sorunsuz ölçeklenir. Şu anda okuduğunuz dokümantasyon, dakikalar içinde çalışmaya başlamanızı sağlamak için düzenlenmiştir—öncelikle kimlik doğrulama, ardından istek oluşturma ve sonunda hata yönetimi, sayfalama ve webhook entegrasyonu için en iyi uygulama kalıpları. Tüm süreç boyunca Python, JavaScript, Java ve C# kod parçacıklarını bulacaksınız; tek bir kod satırının tam bir karşılaştırmayı nasıl tetikleyebileceğini ve gerçek dosyalarla tarayıcınızdan çıkmadan deneyebileceğiniz bir sandbox ortamını gösterecek. Bu rehberin sonunda, güvenilir, yüksek doğruluklu hesap tablosu karşılaştırmasını herhangi bir iş akışına nasıl yerleştireceğinizi, manuel inceleme süresini nasıl azaltacağınızı ve paydaşları şeffaf, denetlenebilir değişim günlükleriyle nasıl güçlendireceğinizi sağlam bir şekilde kavrayacaksınız— ve ayrıca kullanımı kolay olduğu kadar güvenli ve hızlı bir API'yi de kullanmış olacaksınız.

Ana Özellikler

Karşılaştırma API'si, çeşitli platformlar arasında hesap tablosu verilerini uzlaştırırken karşılaşılan en yaygın sorunları ele alan kapsamlı bir özellik setine sahiptir. Öncelikle, API şu dosya formatlarının kapsamlı bir listesini destekler: Apple Numbers (.numbers), düz metin ayrılmış dosyalar (CSV, TSV), eski Excel (.xls) ve modern Excel (.xlsx). Bu, ön dönüşüm araçlarına olan ihtiyacı ortadan kaldırır ve orijinal dosyaları doğrudan hizmete beslemenizi sağlar. Diff motoru hücre seviyesinde çalışır; değerlerde, formüllerde ve hatta yazı tipi stili, hücre gölgelendirme ve veri doğrulama kuralları gibi biçimlendirme özelliklerinde değişiklikleri algılar; her farklılık, sonuç çalışma kitabında özelleştirilebilir renk şemalarıyla açıkça vurgulanır, böylece teknik olmayan inceleyicilerin çıktıyı yorumlaması kolaylaşır. Büyük ölçekli veri setleri için API, artımlı karşılaştırma modunu sunar; bu sayede önceki bir temel noktadan bu yana eklenen veya değiştirilen satırları yalnızca karşılaştırarak işlem süresini ve ağ bant genişliğini azaltırsınız. Ayrıca, görsel diff dosyasına ek olarak değişikliklerin yapılandırılmış bir JSON özetini talep edebilir, bu da uyarıların tetiklenmesi, gösterge tablolarının güncellenmesi veya değişikliklerin sürüm kontrol sistemlerine beslenmesi gibi downstream otomasyonları mümkün kılar. Güvenlik özellikleri arasında OAuth 2.0 taşıyıcı token kimlik doğrulaması, kapsamlı API anahtarları ve isteğe bağlı IP beyaz listesi bulunur; ayrıca dinlenmedeki veri AES‑256 ile şifrelenir. Hizmet, GDPR ve CCPA uyumluluk standartlarına da uyar, böylece hassas kişisel ya da finansal bilgileri yönetirken güven duyarısınız. Performans açısından API düşük gecikme için tasarlanmıştır; yatay ölçekleme ve bellek içi diff algoritmaları sayesinde çoğu karşılaştırma standart boyuttaki çalışma kitapları için bir saniyenin altında tamamlanır, 50 MB'i aşan dosyalar için webhook aracılığıyla asenkron işlem desteği bulunur. Son olarak, geliştirici deneyimi önceliktir: kapsamlı OpenAPI spesifikasyonları, otomatik üretilen SDK'lar, ayrıntılı hata kodları ve gerçek‑zamanlı hız limiti başlıkları API'yi minimum sürtünme ile entegre etmenizi sağlar; sandbox konsolumuz ve geniş örnek deposu, toplu işleme, CI/CD pipeline'ları ve sunucusuz işlevler için en iyi uygulama örneklerini sergiler. Kısacası, Karşılaştırma API'si, format, boyut ya da veri karmaşıklığı ne olursa olsun, tek bir basit çağrı ile değişiklikleri görmenizi sağlayan hızlı, güvenli ve geliştirici‑dostu hesap tablosu diff yetenekleri sunar.

Belgeler

Parametreler

format: Desteklenen bir çıktı dosyası formatı.
UploadFileRequest.OperationId: Bu bir işlem kimliğidir
UploadFileRequest.Files: Bunlar, çevrimiçi hizmetlerimize yüklemeniz gereken dosyalardır; verileri kendi yönteminizle hazırlayabilirsiniz ancak HTML input dosyasının standardına uymalıdır.

Uç Noktayı Kullan

Dosyaları ve erişim token'ını içeren bir istek gönderin Karşılaştırma API

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'
Hizmet, işlenmiş dosya için bir indirme URL'siyle yanıt verir; 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 İndirme API

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