Hämta celldata baserat på namngivet intervall – Aspose.Cells Cloud API

Förutsättningar

  • En giltig JWT-åtkomsttoken med lämpligt omfattning.
  • Arbetsboken måste ha laddats upp till Aspose Cloud-lagring (eller en angiven mapp).
  • Se till att lagringsnamnet anges om du använder en icke-standardlagring.

Denna REST API returnerar en lista över celler i ett intervall som identifieras av ett namngivet intervall eller av rad-/kolumnindex.

Denna åtgärd tillåter utvecklare att programmatiskt hämta värdena på celler som tillhör ett specifikt namngivet intervall i ett Excel-kalkylblad. Genom att ange antingen namedRange-identifieraren eller explicita rad- och kolumnindex returnerar API:et en detaljerad lista över celler, inklusive deras adress, rad, kolumn, värde, datatyp och formateringsinformation. Svaret kan användas för att driva datastyrd programvara, generera rapporter eller utföra ytterligare beräkningar på serversidan. Aspose.Cells Cloud-tjänsten stöder flera programmeringsspråk via sina SDK:er, vilket säkerställer sömlös integration oavsett utvecklingsplattform. Genom att använda HTTPS säkerställs säker överföring av data, och API:et följer REST-principer och returnerar standard HTTP-statuskoder för lyckade och felaktiga åtgärder.

REST API

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

Förfrågningsparametrar

Parameternamn Typ Plats Beskrivning
name string path Namnet på arbetsboksfilen.
sheetName string path Namnet på kalkylbladet i arbetsboken.
namedRange string query Det namngivna intervallet som ska hämtas, t.ex. A1:B2 eller range_name1.
firstRow integer query Nollbaserat index för första raden i intervallet (används när namedRange inte anges).
firstColumn integer query Nollbaserat index för första kolumnen i intervallet (används när namedRange inte anges).
rowCount integer query Antal rader som ska ingå i intervallet.
columnCount integer query Antal kolumner som ska ingå i intervallet.
folder string query Mappen som innehåller arbetsboken.
storageName string query Namnet på molnlagringsplatsen där arbetsboken finns.

OpenAPI-specifikationen definierar ett offentligt tillgängligt programmeringsgränssnitt och låter dig utföra REST-interaktioner direkt från en webbläsare.

Du kan använda verktyget cURL för att enkelt anropa Aspose.Cells-webbtjänster. Exemplet nedan visar hur du begär cellvärden från ett namngivet intervall.

Säkerhetsnotering: Använd alltid HTTPS när du anropar API:et. Tjänsten stöder inte obekräftat HTTP; HTTPS säkerställer att förfrågan är krypterad och följer säkerhetsrekommendationer.

HTTP-statuskoder

Kod Betydelse Beskrivning
200 OK Filter tillämpades framgångsrikt; svaret innehåller åtgärdens detaljer.
400 Felaktig förfrågan Saknade eller ogiltiga parametrar (t.ex. filtyp som inte stöds).
401 Obehörig Ogiltig eller saknad JWT-token.
413 För stor nyttolast Den uppladdade filen överskrider storleksgränsen.
500 Internt serverfel Oväntat serverfel.

Exempel på felaktigt svar (400 Bad Request)

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "Parametern 'namedRange' saknas eller är ogiltig."
}

Tips: API:et använder nollbaserade index för firstRow och firstColumn. Den första raden i kalkylbladet är till exempel 0.

Moln-SDK-familj

Att använda en SDK är det mest effektiva sättet att snabba upp utvecklingen. En SDK abstraher bort detaljer på låg nivå och låter dig fokusera på affärslogik. Se GitHub-förrådet för en komplett lista över Aspose.Cells Cloud SDK:er.

Följande kodexempel visar hur man anropar Aspose.Cells-webbtjänster med olika SDK:er:

Hämta namngivna intervall i en Excel-arbetsbok