Convertir un archivo de Excel a diferentes formatos
Antes de llamar a este punto final, asegúrese de haber obtenido un token JWT válido y de que el libro de trabajo de origen esté almacenado en una ubicación compatible (por ejemplo, Aspose Cloud Storage). Incluya el token en el encabezado Authorization y, si es necesario, especifique el parámetro de consulta storageName.
Esta API REST convierte un archivo de Excel a varios formatos de salida.
API PutConvertWorkBook
PUT https://api.aspose.cloud/v3.0/cells/convert
La solicitud es un PUT HTTP con contenido multipart (consulte RFC 2046 o RFC 1341).
La primera parte del cuerpo multipart contiene el archivo de datos, y la segunda parte contiene las opciones de guardado.
Seguridad y autenticación
Las API de Aspose.Cells Cloud son seguras y requieren autenticación basada en token JWT.
Parámetros de consulta
| Nombre del parámetro | Tipo | Descripción |
|---|---|---|
format |
string | Formato de archivo de destino (por ejemplo, CSV, XLS, HTML, PDF, XML, TXT, TIFF, PNG, JPG, GIF, EMF, BMP, MD, Numbers, WMF, SVG, etc.). |
password |
string | Contraseña necesaria para abrir el archivo de Excel de origen. |
outPath |
string | Ruta completa (incluyendo nombre de archivo y extensión) para un único archivo de salida, o una ruta de carpeta cuando se generan varios archivos. |
storageName |
string | Nombre del almacenamiento donde reside el archivo de origen. |
checkExcelRestriction |
bool | Si es true, valida las restricciones de Excel antes de modificar celdas u objetos relacionados. |
streamFormat |
string | Formato del flujo de archivo de entrada. |
region |
string | Configuración regional aplicada al libro de trabajo. |
pageWideFitOnPerSheet |
bool | Ajusta el ancho de página para que quepa en cada hoja de cálculo al convertir a PDF. |
pageTallFitOnPerSheet |
bool | Ajusta la altura de página para que quepa en cada hoja de cálculo al convertir a PDF. |
sheetName |
string | Nombre de la hoja de cálculo a convertir. |
pageIndex |
string | Índice de la página a convertir (requiere sheetName). |
onePagePerSheet |
bool | Si es true, genera una página PDF por hoja de cálculo. |
AutoRowsFit |
bool | Ajusta automáticamente todas las filas del libro de trabajo. |
AutoColumnsFit |
bool | Ajusta automáticamente el ancho de las columnas del libro de trabajo. |
Parámetros del cuerpo de solicitud
| Nombre del parámetro | Tipo | Descripción |
|---|---|---|
datafile |
data file | El archivo de Excel ubicado en la primera parte del cuerpo multipart. |
SaveOptions |
object | Opciones de guardado ubicadas en la segunda parte del cuerpo multipart. |
Respuesta
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
Códigos de estado HTTP
| Código | Significado | Descripción |
|---|---|---|
| 200 | OK | 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 faltante. |
| 413 | Carga útil demasiado grande | El archivo cargado supera el límite de tamaño. |
| 500 | Error interno del servidor | Error inesperado en el servidor. |
Cómo usar la API PutConvertWorkBook con SDK
Especificación de la API PutConvertWorkBook
La Especificación OpenAPI define una interfaz accesible públicamente que permite interacciones REST directas desde un navegador web.
Ejemplo con cURL
curl -X PUT "https://api.aspose.cloud/v3.0/cells/convert?format=html" \
-H "accept: multipart/form-data" \
-H "Content-Type: multipart/form-data" \
-H "x-aspose-client: Containerize.Swagger" \
-d '{"File":{}}'
Uso de los SDK de Aspose.Cells Cloud
El uso de un SDK acelera el desarrollo al manejar los detalles de bajo nivel, permitiéndole centrarse en la lógica de negocio. 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 con diversos SDK: