Ottenere la descrizione di una riga da un foglio di calcolo Excel – API Aspose.Cells Cloud

Prerequisiti:

Ottieni un token di accesso JWT valido e includilo nell’intestazione Authorization: Bearer <jwt token>.
Assicurati che il file di lavoro sia memorizzato nello storage di Aspose Cloud o specifica il percorso della cartella in cui si trova.
Usa la versione dell’API v3.0 come mostrato nell’URL dell’endpoint.

Questa API REST recupera i dati di una riga in base all’indice all’interno di un foglio di calcolo Excel.

GetWorksheetRow API

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

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	string	path	Nome del file di lavoro.
sheetName	string	path	Nome del foglio di calcolo all’interno del file di lavoro.
rowIndex	integer	path	Indice in base zero della riga da recuperare.
folder	string	query	Cartella contenente il file di lavoro.
storageName	string	query	Nome dello storage in cui risiede il file di lavoro.

La Specifiche OpenAPI definiscono un’interfaccia di programmazione pubblicamente accessibile e consentono di eseguire interazioni REST direttamente da un browser web.

Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come effettuare chiamate all’API Cloud con cURL. Includi l’intestazione Authorization: Bearer <jwt token> per autenticare la richiesta.

Richiesta

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>"

Risposta

{
  "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"
}

Schema della risposta

Proprietà	Tipo	Descrizione
`GroupLevel`	integer	Livello di raggruppamento della riga (usato per l’aggregazione).
`Height`	number	Altezza della riga in punti.
`Index`	integer	Indice in base zero della riga restituita.
`IsBlank`	boolean	Indica se la riga contiene dati.
`IsHeightMatched`	boolean	`true` se l’altezza della riga corrisponde all’altezza predefinita.
`IsHidden`	boolean	`true` se la riga è nascosta.
`Style`	object	Oggetto contenente le informazioni di stile della riga.
`link`	object	Riferimento ipertestuale alla risorsa riga.
`Code`	integer	Codice di stato HTTP della risposta.
`Status`	string	Descrizione testuale dello stato (ad esempio, “OK”).

Note / Gestione errori: L’API può restituire i seguenti codici di stato HTTP:

200 – Successo; i dati della riga vengono restituiti.
401 – Non autorizzato; il token JWT è mancante o non valido.
404 – Non trovato; il file di lavoro, il foglio di calcolo o la riga specificati non esistono.
500 – Errore interno del server; si è verificata una condizione imprevista.

Codice	Descrizione	Soluzione
200	Successo – dati della riga restituiti.	–
401	Non autorizzato – token JWT mancante o non valido.	Fornire un token JWT valido.
404	Non trovato – file di lavoro, foglio di calcolo o riga mancante.	Verificare i nomi e l’indice della riga.
500	Errore interno del server – condizione imprevista.	Contattare il supporto Aspose.

Per un elenco completo dei codici di errore, consulta la documentazione sui codici di errore di Aspose.Cells Cloud.

Famiglia di SDK Cloud

L’utilizzo di un SDK è il metodo più rapido per lo sviluppo. Un SDK astrae i dettagli di basso livello, consentendoti di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come chiamare i servizi web di Aspose.Cells utilizzando vari SDK: