Cómo convertir una hoja de cálculo a CSV mediante la API de Aspose.Cells Cloud
El endpoint ConvertSpreadsheetToCsv recibe un archivo de hoja de cálculo cargado desde una unidad local, procesa la conversión íntegramente en los servidores de Aspose.Cells Cloud y devuelve el archivo CSV resultante como un flujo binario. Esta operación nativa en la nube elimina la necesidad de subir el archivo original al almacenamiento en la nube, reduce los costos de almacenamiento y simplifica el flujo de trabajo para desarrolladores que requieren conversiones rápidas de hojas de cálculo a CSV. Los formatos admitidos dependen de las bibliotecas subyacentes y se requieren permisos adecuados para leer el archivo original. Los errores, como archivos faltantes, solicitudes inválidas o fallos en la conversión, se devuelven con códigos de estado HTTP estándar.
API para convertir hoja de cálculo a CSV
PUT https://api.aspose.cloud/v4.0/cells/convert/spreadsheet/csv
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 | Obligatorio | Descripción |
|---|---|---|---|---|
| Spreadsheet | File | FormData | Obligatorio | El archivo de hoja de cálculo que se va a convertir. Acepta formatos comunes como .xls, .xlsx, .xlsm. Debe proporcionarse como multipart/form‑data. Ejemplo: myWorkbook.xlsx. |
| outPath | String | Query | Opcional | Ruta de la carpeta de destino donde se guardará el CSV convertido. Si se omite, el CSV se devuelve directamente en el cuerpo de la respuesta. Ejemplo: /output/reports/. |
| outStorageName | String | Query | Opcional | Nombre del servicio de almacenamiento en la nube donde se guardará el archivo de salida. Si no se especifica, se utiliza el almacenamiento predeterminado configurado para la cuenta de Aspose.Cells. |
| fontsLocation | String | Query | Opcional | Ruta a una carpeta que contiene fuentes personalizadas necesarias para la hoja de cálculo. Permite representar correctamente celdas que utilizan fuentes no estándar. |
| region | String | Query | Opcional | Configuración de región/idioma de la hoja de cálculo (por ejemplo, es-ES, fr-FR). Influye en el formato numérico, el análisis de fechas y el comportamiento específico de la configuración regional. |
| password | String | Query | Opcional | Contraseña utilizada para abrir hojas de cálculo protegidas con contraseña. Si el archivo está cifrado y se omite o es incorrecta la contraseña, se devuelve un error 400/401. |
Respuesta
En caso de éxito, la API devuelve HTTP 200 (o 202 para procesamiento asíncrono) con el encabezado Content-Type: application/octet-stream. El cuerpo de la respuesta contiene el archivo CSV generado como un flujo binario.
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
Códigos de estado HTTP
| Código | Significado | Descripción |
|---|---|---|
| 200 | OK | Filtro aplicado correctamente; la respuesta contiene detalles de la operación. |
| 400 | Bad Request | Parámetros faltantes o inválidos (por ejemplo, tipo de archivo no admitido). |
| 401 | Unauthorized | Token JWT inválido o faltante. |
| 413 | Payload Too Large | El archivo subido supera el límite de tamaño. |
| 500 | Internal Server Error | Error inesperado en el servidor. |
¿Dónde debería utilizarse la API para convertir hoja de cálculo a CSV?
- Exportación de datos para sistemas de informes – Genere extracciones CSV a partir de informes basados en Excel para alimentar herramientas de BI o almacenes de datos, sin necesidad de manipular archivos manualmente.
- Procesamiento por lotes automatizado – Convierta grandes cantidades de hojas de cálculo almacenadas localmente a CSV en trabajos del lado del servidor, y envíe directamente los resultados a servicios posteriores.
- Aplicaciones web con cargas de archivos – Permita que los usuarios finales suban un archivo de Excel y reciban instantáneamente una versión CSV para su análisis posterior o importación en otras plataformas.
- Integración con sistemas heredados – Traduzca formatos heredados de hojas de cálculo a CSV para sistemas que solo aceptan archivos de texto delimitado plano.
¿Por qué usar la API para convertir hoja de cálculo a CSV?
- Arquitectura sin necesidad de cargar al almacenamiento en la nube – No es necesario almacenar el archivo original en el almacenamiento en la nube; la conversión ocurre directamente desde el flujo cargado, ahorrando tiempo y costos de almacenamiento.
- Procesamiento en la nube de alto rendimiento – Aprovecha el motor de conversión optimizado de Aspose.Cells en servidores escalables en la nube, ofreciendo salidas CSV rápidas incluso para libros grandes.
- Integración sencilla – Una única solicitud PUT con parámetros de consulta opcionales; devuelve el CSV como un flujo binario listo para descargar, eliminando pasos posteriores de procesamiento.
- Soporte completo de características – Maneja archivos protegidos con contraseña, fuentes personalizadas y configuraciones específicas de la región, garantizando conversiones precisas para hojas de cálculo complejas.
Cómo usar la API para convertir hoja de cálculo a CSV con SDK
Especificación de la API para convertir hoja de cálculo a CSV
La Especificación de la API para convertir hoja de cálculo a CSV proporciona una interfaz de programación accesible públicamente para 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.
Utilizar los SDK de Aspose.Cells Cloud
Utilizar los SDK es la forma más rápida de desarrollar, ya que abstracta los detalles de bajo nivel, permitiéndole trabajar con hojas de cálculo mediante código conciso. 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 interactuar con los servicios web de Aspose.Cells mediante diversos SDK: