Hesap Tablosu Dönüştürmeyi Tek Satırda Yapın: Aspose.Cells Cloud Convert API (.NET / Python / Java) için Tam Kılavuz

Yerel Excel kurulumu yok. Bakımı yapılacak dönüşüm sunucusu yok. XLSX → PDF, Excel → CSV/JSON/görseller/HTML’yi basit REST çağrılarına dönüştürün — ve yaklaşık üç dakika içinde ilk “bulut elektronik tablo dönüştürücüsü” çalışıyor olsun.

“Convert that spreadsheet to a different format” günlük geliştirme sürecinde en yaygın gereksinimlerden biridir:

• Finans ve hukuk ekipleri, herkesin düzenleyebileceği bir .xlsx yerine salt okunur, müdahale edilemez PDF raporu istiyor;
• Veri ekipleri, tablo verilerini aşağı akış sistemlerine CSV / JSON olarak çekmek istiyor;
• Web ve mobil uygulamalar, çalışma sayfalarını — hatta grafikleri — doğrudan PNG / SVG formatına render edilmesini istiyor;
• Portallar, gömmek için temiz HTML / HTML-Table snippet’lerini istiyor;
• Birisi, bir yığın .xls / .xlsx / .csv / .ods dosyasını tek bir formata normalleştirmeli.

Eski moda çözümler — yerel bir Excel kurulumu makrolarla birlikte veya kendi sunucunuzda ağır bir COM bileşeni — ölçeklendirmesi zor ve çapraz platformda tutması güçtür. Aspose.Cells Cloud bunların tümünü saf bir REST API ile değiştirir: bir dosya yükleyin, yeni formatta bir dosya alın.

Bu gönderi, Aspose.Cells Cloud mikro hizmetindeki çekirdek ConversionController tarafından sunulan üç dönüşüm API’sini (kaynak: src/Aspose.Cells.Cloud.MicroService/Controllers/ConversionController.cs) inceler ve cURL, C# (.NET), Python ve Java‘da çalıştırılabilir örnekler sunar.

1. Dönüştürme özelliği ne yapabilir?

ConversionController denetleyicisi, format dönüştürme / dışa aktarma için ayrılmıştır. Motor seviyesindeki yüksek doğruluklu dönüşümü üç HTTP API setine sarar:

Uygulama notu: kaynak yolları v{version}/cells önekini API sürümü 4.0 ile kullanır, bu yüzden canlı çağrılar https://api.aspose.cloud/v4.0/cells/... gibi görünür.

Dönüşüm ayrıntısı, “tüm dosya” kavramının çok ötesine gider

Tam bir çalışma kitabını dönüştürmenin yanı sıra, denetleyici tek bir öğe dışa aktarabilir:

• Belirli bir çalışma sayfası → PDF / image / CSV / JSON / HTML
• Belirli bir hücre aralığı (ör. A1:C12) → PDF / image / CSV / JSON / HTML
• Belirli bir tablo → PDF / image / CSV / JSON / HTML
• Belirli bir grafik → PNG / JPEG / BMP / GIF / SVG / TIFF / EMF / PDF

Böylece sadece bir grafiği almak için bütün 50 MB’lik bir çalışma kitabını dönüştürmek zorunda kalmazsınız — sadece ihtiyacınız olanı dönüştürün ve bant genişliği ile işlem gücünden tasarruf edin.

2. Hangi formatlar destekleniyor?

Denetleyicide yerleşik ExportData kayıt defterine dayanarak, dönüşüm matrisi kabaca şu şekilde görünür:

Kısaca: spreadsheet-to-spreadsheet her türlü dönüşüm, plus tüm spreadsheet → PDF / görüntü / web-veri çıktıları ailesi — hepsi tek bir API yüzeyi altında.

3. Başlamadan önce ihtiyacınız olan iki şey

1. Aspose Cloud Dashboard’da ücretsiz bir hesap kaydedin ve bir Uygulama oluşturup Client ID ve Client Secret alın (SDK’lar bunları otomatik olarak bir JWT ile değiştirir — kimlik doğrulama başlıklarını kendiniz oluşturmanıza gerek yok).
2. Seçtiğiniz dil için SDK’yı kurun:

<!-- .NET -->
<PackageReference Include="Aspize.Cells-Cloud" Version="25.x" />

# Python
pip install asposecellscloud

<!-- Java (Maven) — note: NOT on Maven Central, so the Aspose repo below is required -->
<repositories>
    <repository>
        <id>AsposeJavaAPI</id>
        <name>Aspose Java API</name>
        <url>https://repository.aspose.cloud/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-cells-cloud</artifactId>
    <version>26.8</version>
</dependency>

SDK gerekli değil mi? Her şey düz REST, bu yüzden cURL da aynı şekilde çalışır (aşağıya bakın).

4. Senaryo 1: Yerel bir Excel dosyasını çevrimiçi dönüştürün (başlık Convert API)

Bu, PUT /v4.0/cells/convert/spreadsheet — amiral gemisi “Convert” API’sidir: istek gövdesine yerel dosyanızı yükleyin, sunucu dönüştürür ve yeni dosyayı geri akıtır. Bulut depolamada hiçbir şey kalıcı değildir ve yükleme kopyası kalmaz — “just convert this for me” anları için mükemmeldir.

① cURL

# 1) First, get a token
curl -X POST "https://api.aspose.cloud/connect/token" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

# 2) XLSX -> PDF
curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/spreadsheet?format=pdf" \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@Book1.xlsx" \
  -o Book1.pdf

format‘ı csv, json, png, xlsx… ile değiştirin ve o formatı elde edin. Tek parametre, tek çıktı formatı.

② C# / .NET

using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Request;

var cellsApi = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

var request = new ConvertSpreadsheetRequest(
    spreadsheet: "C:/invoices/Book1.xlsx",   // local file path
    format: "pdf");                          // target: pdf / csv / json / png ...

using Stream result = cellsApi.ConvertSpreadsheet(request); // converted file stream
using var outFile = File.Create("C:/invoices/Book1.pdf");
result.CopyTo(outFile);

// Even simpler: point the SDK at an output path and let it write the file
// cellsApi.ConvertSpreadsheet(request, "C:/invoices/Book1.pdf");

Bir toplu iş mi gerekiyor? Bunu bir dizin üzerinde döngüye yerleştirin ve “tüm klasörü XLSX → PDF olarak dönüştür” elde edersiniz.

③ Python

from asposecellscloud.apis.cells_api import CellsApi
from asposecellscloud.requests import ConvertSpreadsheetRequest
import os

instance = CellsApi(
    os.getenv('CellsCloudClientId'),
    os.getenv('CellsCloudClientSecret'))

# Local XLSX -> PDF, result written locally
instance.convert_spreadsheet(
    ConvertSpreadsheetRequest("Book1.xlsx", "pdf"),
    local_outpath="Book1.pdf")

# Other formats: just change the parameter — json / csv / xlsx / png ...

④ Java

import com.aspose.cloud.cells.api.CellsApi;
import com.aspose.cloud.cells.request.ConvertSpreadsheetRequest;
import java.io.File;

public class ConvertDemo {
    public static void main(String[] args) throws Exception {
        CellsApi api = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

ConvertSpreadsheetRequest req = new ConvertSpreadsheetRequest();
        req.setSpreadsheet("C:/invoices/Book1.xlsx");   // local file path
        req.setFormat("pdf");                           // target: pdf / csv / json / png ...

File out = api.convertSpreadsheet(req);         // converted result as a File
        out.renameTo(new File("C:/invoices/Book1.pdf"));
        System.out.println("Converted: " + out.getAbsolutePath());
    }
}

Dört dil, bir eylem: bir yol + bir format parametresi ver → hedef dosyayı geri al. Bu, Convert API’nin tüm satış noktasıdır — çağıran tarafında sıfır Excel bağımlılığı, şablon yok, COM bileşeni yok.

5. Senaryo 2: Bulutta depolanan bir dosyayı doğrudan dönüştür

Aspose Cloud Storage (veya kendi nesne depolamanız) içinde zaten bir dosya bulunduğunda, büyük dosyaları indirme/yükleme yapmanıza gerek yoktur — dönüşüm bulutta gerçekleşir, veri transferini en aza indirir ve büyük çalışma kitaplarında performansı artırır:

# cloud Book1.xlsx -> PDF, downloaded locally
curl -G "https://api.aspose.cloud/v4.0/cells/Book1.xlsx" \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "format=pdf" \
  --data-urlencode "folder=Reports" \
  -o Book1.pdf

from asposecellscloud.apis.cells_api import CellsApi
from asposecellscloud.requests import ExportSpreadsheetAsFormatRequest

instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET")

# Convert a cloud-stored workbook straight to PDF
instance.export_spreadsheet_as_format(
    ExportSpreadsheetAsFormatRequest("Book1.xlsx", format="pdf", folder="Reports"))

Tek bir öğeye de dalabilirsiniz — örn. “Sheet1’deki 3. grafik” PNG olarak (cloud-storage çeşidi) render edebilirsiniz:

# chart -> PNG
curl -G "https://api.aspose.cloud/v4.0/cells/Book1.xlsx/worksheets/Sheet1/charts/2" \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "format=png" \
  -o chart.png

Granüler bulut uç noktalarına bir bakış:

6. Senaryo 3: SaveAs — sonucu bulut depolamaya geri yaz

Dönüştürülen dosyanın bulut depolamaya geri kaydedilmesini (indirilmesi yerine) istediğinizde PUT /v4.0/cells/{name}/saveas kullanın. Bu, “bugünün raporunu arşivleme için PDF olarak dışa aktarma, her gün” gibi otomasyonlar için doğal bir çözümdür:

curl -X PUT "https://api.aspose.cloud/v4.0/cells/Book1.xlsx/saveas?format=pdf" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

from asposecellscloud.apis.cells_api import CellsApi
from asposecellscloud.requests import SaveSpreadsheetAsRequest

instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET")
instance.save_spreadsheet_as(
    SaveSpreadsheetAsRequest("Book1.xlsx", format="pdf", folder="Reports"))
# Result is saved directly in cloud storage; returns CellsCloudResponse(Code=200, Status="OK")

İnce ayarlı kaydetme seçeneklerini SaveOptionsData istek gövdesi aracılığıyla geçirebilir ve çıktı dosya adı, çıktı depolama, özel yazı tipleri, bölge/yerel ayar, şifre gibi öğeleri sorgu parametreleriyle kontrol edebilirsiniz — bunlar hakkında daha fazla bilgi aşağıdaki Mühendislik detayları bölümünde.

7. Daha fazla hazır “online dönüştürme” uç noktası

Yukarıdaki çalışma kitabı düzeyindeki dönüşümlerin yanı sıra, denetleyici, local-file → specific-target gibi özel uç noktaların tam bir setini sunar (Senaryo 1’deki gibi aynı istek gövdesi yüklemesi), bu da daha ayrıntılı ve bant genişliği açısından daha ucuzdur:

Örneğin, “bu aralığı yalnızca aşağı akış sistemine CSV olarak dışa aktar”:

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/range/csv" \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "worksheet=Sheet1" \
  --data-urlencode "range=A1:C100" \
  -F "file=@data.xlsx" \
  -o data.csv

Bu uç noktalar, convert/spreadsheet ile aynı gövdeye yükleme desenini kullanır. .NET SDK’sında chart durumları, bu v4.0 rotalarına eşlenen tiplenmiş sarmalayıcılara sahiptir — ConvertChartToImage (convert/chart/image) ve ConvertChartToPdf (convert/chart/pdf). worksheet/*, range/* ve table/* varyantlarının henüz v4.0 sarmalayıcısı yoktur, bu yüzden onları yukarıdaki cURL gibi düz REST üzerinden çağırın.

8. Mühendislik detayları ve hata yönetimi

Bilmeniz gereken dönüşüm seçenekleri (sorgu parametreleri)

• password — şifre korumalı çalışma kitaplarını açar;
• fontsLocation / custom-font support — PDF/görüntüler oluşturulurken gliflerin doğru kalmasını sağlar;
• satır/sütun otomatik sığdırma ve satır/sütun başlıklarını (printHeadings) yazdırıp yazdırmayacağınız, bölge/sayfa ayarı (region) vb.;
• çıktı tarafı: outPath / outStorageName sonucun bulut depolamada nereye yerleştirileceğini belirler;

Hata kodları (denetleyicinin belgelerindeki sözleşme)

Kimlik Doğrulama

Tüm SDK’lar OAuth 2.0 client_credentials ve bir JWT ile otomatik olarak kimlik doğrulaması yapar; ham cURL kullanırken önce bir kez /connect/token çağırın (bkz. Senaryo 1, ① yukarıda).

9. Neden Aspose.Cells Cloud Convert?

• ✅ Sıfır yerel bağımlılık — Office/Excel yok, COM yok. Herhangi bir dil ve platformda (Linux, konteynerler, sunucusuz) çağrılabilir;
• ✅ Yüksek doğrulukta render — Aspose.Cells motoru tarafından desteklenir, böylece formüller, grafikler, stiller ve sayfalama PDF/görsellere profesyonel kalitede render edilir;
• ✅ Bulut yerel — dosyalar dönüşüm sırasında bulutta kalabilir, büyük veri yüklemelerinden kaçınılır; tamamen çevrimiçi dönüşüm hiç bulut depolama gerektirmez;
• ✅ Esnek granülerlik — çalışma kitabı / çalışma sayfası / aralık / tablo / grafik: ihtiyacınız olan parçayı tam olarak dönüştürün;
• ✅ SDK’lar arasında tek şekil — cURL, .NET, Python ve Java örnekleri 1:1 eşleşir, böylece beğendiğiniz deseni doğrudan kopyalayabilirsiniz.

Hemen başlayın: Aspose Cloud Dashboard adresinde kaydolun, bir Uygulama oluşturun, kimlik bilgilerinizi yukarıdaki herhangi bir kod parçacığına bırakın ve çalıştırın — birkaç dakika içinde kendi “bulut Excel dönüştürücünüz” olacak.

Bunu faydalı buldunuz mu? Yıldızlayın, yer işareti koyun veya paylaşın — ve yorumlarda kendi tablo-dönüştürme kullanım senaryolarınızı bize anlatın.