Excel Dosyasını Aspose.Cells Cloud API ile JSON'a Dönüştürme – Hızlı Kılavuz

REST API

Bu REST API, bir elektronik tablo dosyasını JSON formatlı bir dosyaya dönüştürür.

POST https://api.aspose.cloud/v3.0/cells/convert/json

Güvenlik ve Kimlik Doğrulama

Aspose.Cells Cloud API’leri güvenlidir ve JWT token tabanlı kimlik doğrulama gerektirir.

İstek

Sorgu Parametreleri

Parametre Adı	Tür	Açıklama
`password`	string	Excel dosyasını açmak için gereken şifre (isteğe bağlı).
`storageName`	string	Dosyanın bulunduğu depo adı (isteğe bağlı).
`checkExcelRestriction`	bool	Hücreleri düzenlerken Excel’e özel kısıtlamaları zorunlu kılar (isteğe bağlı).

İstek Gövdesi Parametresi

Parametre Adı	Tür	Açıklama
`datafile`	file	Yüklenecek Excel dosyası. `multipart/form-data` isteğiyle ilk parça olarak gönderilmelidir.

Örnek cURL Çağrısı

curl -X POST "https://api.aspose.cloud/v3.0/cells/convert/json" \
     -H "Authorization: Bearer $ACCESS_TOKEN" \
     -H "accept: application/json" \
     -H "Content-Type: multipart/form-data" \
     -F "File=@myWorkbook.xlsx"

Yanıt

Hizmet, bir FileInfo nesnesi döndürür. Önemli alanlar aşağıda açıklanmıştır:

Alan	Tür	Açıklama
`Filename`	string	Oluşturulan JSON dosyasının adı (örneğin, `myWorkbook.json`).
`FileSize`	integer	Oluşturulan dosyanın bayt cinsinden boyutu.
`FileContent`	string	JSON dosyasının Base64 ile kodlanmış içeriği. Gerçek JSON içeriğini almak için kodunu çözün.

Örnek yanıt

{
  "Filename": "myWorkbook.json",
  "FileSize": 8423,
  "FileContent": "eyJmb3JtYXR0ZWRfZGF0YSI6IH ... (base64 string) ..."
}

Hata Yönetimi

İstek başarısız olursa, API aşağıdaki yapıya sahip bir hata nesnesi döndürür:

Alan	Tür	Açıklama
`Code`	string	Makine tarafından okunabilir hata tanımlayıcısı.
`Message`	string	Hatanın insan tarafından okunabilir açıklaması.

Yaygın HTTP durum kodları:

400 – Geçersiz istek (örneğin, eksik dosya, geçersiz parametreler).
401 – Yetkisiz erişim (geçersiz veya eksik erişim belirteci).
500 – İç sunucu hatası.

HTTP Durum Kodları

Kod	Anlam	Açıklama
200	Tamam	Filtre başarıyla uygulandı; yanıt işlem ayrıntılarını içerir.
400	Geçersiz İstek	Eksik veya geçersiz parametreler (örneğin, desteklenmeyen dosya türü).
401	Yetkisiz Erişim	Geçersiz veya eksik JWT belirteci.
413	Yük Çok Büyük	Yüklenecek dosya boyut sınırını aşıyor.
500	İç Sunucu Hatası	Beklenmeyen sunucu hatası.

SDK ile PostConvertWorkbookToJson API Nasıl Kullanılır

PostConvertWorkbookToJson API Tanımı

OpenAPI Tanımı, herkese açık bir programlama arayüzü tanımlar ve REST etkileşimlerini doğrudan bir web tarayıcısından gerçekleştirmenize olanak tanır.

Aspose.Cells web hizmetlerine kolayca erişmek için cURL komut satırı aracını kullanabilirsiniz. Aşağıdaki örnek, cURL ile Bulut API’sine nasıl çağrı yapılacağını göstermektedir.

İstek

curl -X POST "https://api.aspose.cloud/v3.0/cells/convert/json" \
     -H "Authorization: Bearer $ACCESS_TOKEN" \
     -H "accept: application/json" \
     -H "Content-Type: multipart/form-data" \
     -F "File=@myWorkbook.xlsx"

Yanıt

{
  "Filename": "myWorkbook.json",
  "FileSize": 8423,
  "FileContent": "eyJmb3JtYXR0ZWRfZGF0YSI6IH... (base64 string)"
}

Aspose.Cells Cloud SDK’larını Kullanın

SDK kullanmak, geliştirme sürecini hızlandırmanın en iyi yoludur. SDK, düşük seviye ayrıntıları yöneterek size proje görevlerinize odaklanma imkanı sunar. Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub deposuna bakın.

Aşağıdaki kod örnekleri, çeşitli SDK’lar kullanılarak Aspose.Cells web hizmetlerine nasıl çağrı yapıldığını göstermektedir:

Benzer işlevselliği uygulayan diğer API’ler

POST /cells/{name}/saveAs – Excel dosyasını ek ayarlarla HTML dosyası olarak kaydeder ve sonucu belirtilen depoya saklar.
PUT /cells/convert – Excel dosyasını ek ayarlarla HTML dosyasına dönüştürür ve sonucu yanıtta döndürür.
GET /cells/{name} – Excel dosyasını alır; dosyayı HTML formatında almak için sorgu parametreleriyle birlikte kullanılabilir.

Excel Dosyasını HTML'ye Dönüştür