Obtener la descripción de una fila en una hoja de cálculo de Excel – API de Aspose.Cells Cloud

Requisitos previos:

Obtener un token de acceso JWT válido e incluirlo en el encabezado Authorization: Bearer <jwt token>.
Asegurarse de que el libro esté almacenado en el almacenamiento de Aspose Cloud o especificar la ruta de la carpeta donde se encuentra.
Utilizar la versión de la API v3.0, tal como se muestra en la URL del endpoint.

Esta API REST recupera datos de fila mediante su índice en una hoja de cálculo de Excel.

API GetWorksheetRow

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

Seguridad y autenticación

Las API de Aspose.Cells Cloud son seguras y requieren autenticación mediante token JWT.

Parámetros de solicitud

Nombre del parámetro	Tipo	Ubicación	Descripción
name	string	path	Nombre del archivo del libro.
sheetName	string	path	Nombre de la hoja de cálculo dentro del libro.
rowIndex	integer	path	Índice de base cero de la fila que se va a recuperar.
folder	string	query	Carpeta que contiene el libro.
storageName	string	query	Nombre del almacenamiento donde reside el libro.

La Especificación OpenAPI define una interfaz de programación públicamente accesible y permite realizar interacciones REST directamente desde un navegador web.

Puede utilizar la herramienta de línea de comandos cURL para acceder fácilmente a los servicios web de Aspose.Cells. El siguiente ejemplo muestra cómo realizar llamadas a la API en la nube con cURL. Incluya el encabezado Authorization: Bearer <jwt token> para autenticar la solicitud.

Solicitud

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

Respuesta

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

Esquema de respuesta

Propiedad	Tipo	Descripción
`GroupLevel`	integer	Nivel de agrupación (usado para agrupaciones).
`Height`	number	Altura de la fila en puntos.
`Index`	integer	Índice de base cero de la fila devuelta.
`IsBlank`	boolean	Indica si la fila contiene algún dato.
`IsHeightMatched`	boolean	`true` si la altura de la fila coincide con la altura predeterminada.
`IsHidden`	boolean	`true` si la fila está oculta.
`Style`	object	Objeto que contiene información de estilo para la fila.
`link`	object	Referencia de hipervínculo al recurso de fila.
`Code`	integer	Código de estado HTTP de la respuesta.
`Status`	string	Descripción textual del estado (por ejemplo, “OK”).

Notas / Manejo de errores: La API puede devolver los siguientes códigos de estado HTTP:

200 – Éxito; se devuelve la información de la fila.
401 – No autorizado; el token JWT falta o no es válido.
404 – No encontrado; el libro, hoja de cálculo o fila especificados no existen.
500 – Error interno del servidor; se produjo una condición inesperada.

Código	Descripción	Solución
200	Éxito – se devuelve la información de la fila.	–
401	No autorizado – token JWT ausente o no válido.	Proporcione un token JWT válido.
404	No encontrado – libro, hoja de cálculo o fila ausentes.	Verifique los nombres y el índice de fila.
500	Error interno del servidor – condición inesperada.	Póngase en contacto con el soporte de Aspose.

Para obtener una lista completa de códigos de error, consulte la documentación de Códigos de error de Aspose.Cells Cloud.

Familia de SDK en la nube

Utilizar un SDK es la forma más rápida de desarrollar. Un SDK abstracta los detalles de bajo nivel para que pueda centrarse en las tareas de su proyecto. Consulte el repositorio de GitHub para obtener una lista completa de los SDK de Aspose.Cells Cloud.

Los siguientes ejemplos de código muestran cómo llamar a los servicios web de Aspose.Cells utilizando varios SDK: