Documentation – Aspose.Cells Cloud API ile bir Excel Çalışma Sayfasından Tek Bir Satır Alın

Developer-Guide: Bir Excel Çalışma Sayfasından Satır Açıklaması Alın

Mon, 01 Jan 0001 00:00:00 +0000

Ön Gereksinimler:

Geçerli bir JWT erişim belirteci edinin ve bunu Authorization: Bearer <jwt token> başlığına ekleyin.
Çalışma kitabının Aspose Cloud deposunda depolandığından emin olun veya yer aldığı klasör yolunu belirtin.
Uç nokta URL’inde gösterildiği gibi API sürümünü v3.0 olarak kullanın.

Bu REST API, bir Excel çalışma sayfasındaki satır verilerini indeksine göre alır.

GetWorksheetRow API

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/{rowIndex}

Güvenlik ve Kimlik Doğrulama

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

İstek Parametreleri

Parametre Adı	Tür	Konum	Açıklama
name	string	path	Çalışma kitabının dosya adı.
sheetName	string	path	Çalışma kitabındaki çalışma sayfasının adı.
rowIndex	integer	path	Alınacak satırın sıfır tabanlı indeksi.
folder	string	query	Çalışma kitabını içeren klasör.
storageName	string	query	Çalışma kitabının bulunduğu depo adı.

OpenAPI Specification, 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 Cloud API’ye istek nasıl atılacağını göstermektedir. İsteği kimlik doğrulamak için Authorization: Bearer <jwt token> başlığını ekleyin.

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/0" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Yanıt

{
  "Row": {
    "GroupLevel": 0,
    "Height": 13.5,
    "Index": 0,
    "IsBlank": false,
    "IsHeightMatched": true,
    "IsHidden": false,
    "Style": {
      "link": {
        "Href": "/style",
        "Rel": "self"
      }
    },
    "link": {
      "Href": "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/cells/rows/0",
      "Rel": "self"
    }
  },
  "Code": 200,
  "Status": "OK"
}

Yanıt şeması

Özellik	Tür	Açıklama
`GroupLevel`	integer	Satırın taslak düzeyi (gruplama için kullanılır).
`Height`	number	Satırın nokta cinsinden yüksekliği.
`Index`	integer	Döndürülen satırın sıfır tabanlı indeksi.
`IsBlank`	boolean	Satırda herhangi bir veri olup olmadığını gösterir.
`IsHeightMatched`	boolean	Satır yüksekliği varsayılan satır yüksekliğiyle eşleşiyorsa `true`.
`IsHidden`	boolean	Satır gizliyse `true`.
`Style`	object	Satır için stil bilgilerini içeren nesne.
`link`	object	Satır kaynağına yönelik hiperbağlantı referansı.
`Code`	integer	Yanıtın HTTP durum kodu.
`Status`	string	Durumun metinsel açıklaması (örneğin, “OK”).

Notlar / Hata Yönetimi: API aşağıdaki HTTP durum kodlarından birini döndürebilir:

200 – Başarılı; satır verileri döndürülür.
401 – Yetkisiz; JWT belirteci eksik veya geçersiz.
404 – Bulunamadı; belirtilen çalışma kitabı, çalışma sayfası veya satır mevcut değil.
500 – Sunucu iç hatası; beklenmeyen bir durum oluştu.

Kod	Açıklama	Giderme
200	Başarılı – satır verileri döndürüldü.	–
401	Yetkisiz – eksik veya geçersiz JWT belirteci.	Geçerli bir JWT belirteci sağlayın.
404	Bulunamadı – çalışma kitabı, çalışma sayfası veya satır eksik.	Adları ve satır indeksini kontrol edin.
500	Sunucu iç hatası – beklenmeyen durum.	Aspose desteğiyle iletişime geçin.

Hata kodlarının tam listesi için Aspose.Cells Cloud Hata Kodları belgesine bakın.

Cloud SDK Ailesi

SDK kullanmak geliştirmenin en hızlı yoludur. Bir SDK, düşük seviyeli ayrıntıları soyutlayarak proje görevlerinize odaklanmanıza olanak tanır. Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub deposuna bakın.

Aşağıdaki kod örnekleri, farklı SDK’lar kullanılarak Aspose.Cells web hizmetlerine nasıl istek atılacağını göstermektedir:

Developer-Guide: Excel çalışma sayfasından satır bilgilerini alın

Mon, 01 Jan 0001 00:00:00 +0000

Bu REST API, bir Excel çalışma sayfasından satır bilgilerini alır.

Önkoşullar
Bu uç noktayı çağırmak için Authorization başlığında geçerli bir JWT belirteci sağlamalısınız. Belirteç, Aspose.Cloud kimlik doğrulama akışı kullanılarak elde edilmeli ve Hücre işlemleri için gerekli kapsamları içermelidir. API, v3.0 sürümleme şemasını takip eder ve standart hız sınırlama politikalarına tabidir.

GetWorksheetRows API

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows

Güvenlik ve Kimlik Doğrulama

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

İstek parametreleri

Parametre Adı	Tür	Konum	Açıklama
name	string	path	Çalışma kitabının adı.
sheetName	string	path	Çalışma sayfasının adı.
folder	string	query	Çalışma kitabının klasörü.
storageName	string	query	Depo adı.

OpenAPI Spesifikasyonu, herkese açık bir programlama arayüzü tanımlar ve REST etkileşimlerini doğrudan bir web tarayıcısından gerçekleştirmenizi sağlar.

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

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Yanıt

{
  "Rows": {
    "MaxRow": 20,
    "RowsCount": 17,
    "RowsList": [
      { "link": { "Href": "/0", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/1", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/2", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/3", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/4", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/5", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/6", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/7", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/8", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/9", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/10", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/11", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/12", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/13", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/14", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/15", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/16", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/17", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/18", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/19", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/20", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/21", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/22", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/23", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/24", "Rel": "self", "Title": null, "Type": null } }
    ],
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/cells/rows",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

Yanıt kodları

Kod	Anlam	Açıklama
200	OK (Tamam)	İstek başarılı oldu ve satır bilgileri döndürüldü.
400	Bad Request (Hatalı İstek)	İstek bozuk (örneğin, gerekli parametreler eksik).
401	Unauthorized (Yetkisiz)	Geçersiz veya eksik JWT belirteci.
404	Not Found (Bulunamadı)	Belirtilen çalışma kitabı veya çalışma sayfası mevcut değil.
500	Internal Server Error (İç Sunucu Hatası)	Sunucuda beklenmeyen bir hata oluştu.

Cloud SDK Family (Bulut SDK Ailesi)

SDK kullanmak, geliştirme sürecini hızlandırmanın en iyi yoludur. Bir SDK, düşük seviye detayları ele aldığı için projenizin görevlerine odaklanabilirsiniz. Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub deposuna göz atın.

Aşağıdaki kod örnekleri, farklı SDK’lar kullanılarak Aspose.Cells web servislerine nasıl istek yapılacağını göstermektedir:

İstek

curl -X GET "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows" -H "accept: application/json"

Yanıt

{
  "Rows": {
    "MaxRow": 20,
    "RowsCount": 17,
    "RowsList": [
      { "link": { "Href": "/0", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/1", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/2", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/3", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/4", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/5", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/6", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/7", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/8", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/9", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/10", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/11", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/12", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/13", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/14", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/15", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/16", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/17", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/18", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/19", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/20", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/21", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/22", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/23", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/24", "Rel": "self", "Title": null, "Type": null } }
    ],
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/cells/rows",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

Cloud SDK Family (Bulut SDK Ailesi)

SDK kullanmak, geliştirme sürecini hızlandırmanın en iyi yoludur. Bir SDK, düşük seviye detayları ele aldığı için projenizin görevlerine odaklanabilirsiniz. Çalışma sayfası satırlarını alma için dil özelinde kod örnekleri aşağıdadır.