Exportar una página de hoja de cálculo – Referencia de la API en la nube de Aspose.Cells

Exportar una página específica de una hoja de cálculo resulta útil cuando necesita una instantánea imprimible de un informe, una imagen de gráfico o un extracto de datos, sin tener que descargar todo el libro de trabajo. Este endpoint le permite recuperar una única página en el formato que mejor se adapte a su flujo de trabajo posterior.

La API GET /cells/{name}/worksheets/{sheetName} le permite convertir una página específica de una hoja de cálculo en distintos formatos de archivo. Los formatos admitidos son: XLS, XLSX, XLSB, CSV, TSV, XLSM, ODS, TXT, PDF, OTS, XPS, DIF, PNG, JPEG, GIF, BMP, WMF, TIFF, EMF, NUMBERS, FODS.

API REST

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

Requisitos previos – Debe disponer de un token JWT de autenticación válido y del libro de trabajo almacenado en una carpeta en la nube que especifique mediante el parámetro folder.

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 una llamada a la API en la nube mediante cURL.

Solicitud

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1?format=png&verticalResolution=100&horizontalResolution=90&pageIndex=1&folder=DotnetFiles" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Respuesta

Respuesta – El servicio devuelve la página solicitada en el formato elegido. Para formatos de imagen (png, jpeg, gif, etc.), el cuerpo contiene la imagen binaria; para formatos de documento (pdf, xls, csv, etc.), el cuerpo contiene el contenido del archivo. Una llamada correcta devuelve HTTP 200.

Ejemplo de respuesta PNG (fragmento base64 truncado):

iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABG0lEQVR42mNkYGBg+M+ABbJw
...

Parámetros

Parámetro	Tipo	Descripción	Valor predeterminado
`format`	string	Formato del archivo de salida (por ejemplo, `pdf`, `png`, `csv`).	`pdf`
`verticalResolution`	integer	Resolución vertical (DPI) de la imagen renderizada.	`100`
`horizontalResolution`	integer	Resolución horizontal (DPI) de la imagen renderizada.	`100`
`pageIndex`	integer	Índice de página (base cero) de la hoja de cálculo que se va a exportar (`0` = primera página).	`0`
`folder`	string	Carpeta del almacenamiento en la nube donde se encuentra el libro de trabajo de origen.	—

Códigos de estado HTTP

Código	Significado	Descripción
200	Correcto	Filtro aplicado correctamente; la respuesta contiene los detalles de la operación.
400	Solicitud incorrecta	Parámetros faltantes o no válidos (por ejemplo, tipo de archivo no admitido).
401	No autorizado	Token JWT no válido o ausente.
413	Carga útil demasiado grande	El archivo cargado excede el límite de tamaño.
500	Error interno del servidor	Error inesperado del servidor.

Posibles errores

401 No autorizado – Token JWT no válido o ausente.
404 No encontrado – El libro de trabajo o la hoja de cálculo especificados no existen.
400 Solicitud incorrecta – Valor de parámetro no válido (por ejemplo, format no admitido).
500 Error interno del servidor – Problema inesperado en el lado del servidor.

Familia de SDK en la nube

Utilizar un SDK es la mejor forma de acelerar el desarrollo. Un SDK gestiona los detalles de bajo nivel, lo que le permite 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 diversos SDK:

Exportar un área de hoja de cálculo a PNG, PDF, CSV – Aspose.Cells Cloud API