Aspose.Cells Cloud: Convertir libro de Excel a PDF, CSV, HTML y más (GET /cells/{name})
Esta API REST recupera un libro de Excel en un formato diferente.
API GetWorkBook
GET https://api.aspose.cloud/v3.0/cells/{name}
Seguridad y autenticación
Las API de Aspose.Cells Cloud son seguras y requieren autenticación mediante token JWT.
Parámetros de consulta
| Nombre del parámetro | Tipo | Descripción | Valor predeterminado |
|---|---|---|---|
| format | string | Formato de archivo de destino (por ejemplo, CSV, XLS, HTML, MHTML, ODS, PDF, XML, TXT, TIFF, XLSB, XLSM, XLSX, XLTM, XLTX, XPS, PNG, JPG, GIF, EMF, BMP, MD, Numbers, WMF, SVG, etc.). | – |
| password | string | Contraseña necesaria para abrir el archivo de Excel. | – |
| isAutoFit | bool | Ajusta automáticamente el ancho de filas y columnas. | false |
| onlySaveTable | bool | Si es true, solo se guarda la información de la tabla. Acepta true o false. |
false |
| outPath | string | Ruta donde guardar el resultado. Para un solo archivo, incluya el nombre y extensión del archivo; para varios archivos, especifique únicamente la carpeta. | – |
| outStorageName | string | Nombre del almacenamiento donde se guardará el archivo de salida. | – |
| checkExcelRestriction | bool | Verifica las restricciones de Excel al modificar celdas u objetos relacionados. | false |
| region | string | Configuración regional aplicada al libro de trabajo. | – |
| pageWideFitOnPerSheet | bool | Ajusta el ancho de página a cada hoja de cálculo al convertir a PDF. | false |
| pageTallFitOnPerSheet | bool | Ajusta la altura de página a cada hoja de cálculo al convertir a PDF. | false |
| onePagePerSheet | bool | Genera una página PDF por hoja de cálculo. | false |
| folder | string | Ruta de la carpeta donde se encuentra el libro de trabajo original. | – |
| storageName | string | Nombre del almacenamiento donde se encuentra el archivo fuente. | – |
Respuesta
Éxito (200)
-
La API devuelve un objeto Workbook que contiene información sobre la estructura del libro cuando se omite el parámetro de consulta
format. -
La API devuelve el archivo convertido en el formato solicitado cuando el parámetro de consulta
formatespecifica un tipo de archivo.
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="book1.pdf"
Content-Length: 123456
(datos binarios del PDF)
Códigos de estado HTTP
| Código | Significado | Descripción |
|---|---|---|
| 200 | Correcto | Filtro aplicado correctamente; la respuesta contiene 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 inválido o ausente. |
| 413 | Carga demasiado grande | El archivo cargado supera el límite de tamaño. |
| 500 | Error interno del servidor | Error inesperado en el servidor. |
Notas:
- Los libros de trabajo grandes pueden tardar más en convertirse; considere aumentar el tiempo de espera de la solicitud.
- Algunos formatos (por ejemplo,
ODS) no son compatibles con ciertas características de Excel, como macros.
Cómo usar la API GetWorkBook con SDK
Requisitos previos:
- Un token de acceso JWT válido obtenido mediante el flujo de autenticación de Aspose.Cells.
- El libro de trabajo fuente debe estar almacenado en un almacenamiento admitido por Aspose o proporcionarse directamente en la solicitud.
- Asegúrese de que la versión de la API (
v3.0) coincida con la versión más reciente publicada.
Especificación de la API GetWorkBook
La Especificación OpenAPI define una interfaz de programación accesible públicamente y le permite realizar interacciones REST directamente desde un navegador web.
Ejemplo de solicitud
Puede utilizar la herramienta de línea de comandos cURL para acceder a los servicios web de Aspose.Cells. El siguiente ejemplo muestra una solicitud GET correcta con el encabezado de autorización requerido.
Utilizar los SDK de Aspose.Cells Cloud
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 ver la lista completa de SDK de Aspose.Cells Cloud.
Los siguientes ejemplos de código muestran cómo llamar a los servicios web de Aspose.Cells mediante diversos SDK:
Consulte también
Ultima actualización: 2024-12-01