Cómo convertir una hoja de cálculo de una hoja de Excel a CSV usando la API de Aspose.Cells Cloud
El endpoint ConvertWorksheetToCsv transforma una única hoja de cálculo de un archivo local en un documento CSV directamente en los servidores de Aspose.Cells Cloud. Al cargar el archivo fuente y especificar la hoja objetivo, los desarrolladores reciben un flujo binario CSV sin necesidad de almacenar el archivo en el almacenamiento en la nube. Esta API es ideal para automatizar la extracción de datos, integrar datos de hojas de cálculo en sistemas posteriores y reducir la sobrecarga de almacenamiento.
API para convertir hoja de cálculo a CSV
API web
PUT https://api.aspose.cloud/v4.0/cells/convert/worksheet/csv
Seguridad y autenticación
Las APIs de Aspose.Cells Cloud son seguras y requieren autenticación basada en token JWT.
-H "Authorization: Bearer {access_token}"
Parámetros de solicitud
| Nombre del parámetro | Tipo | Ubicación | Obligatorio/Opcional | Descripción |
|---|---|---|---|---|
| Spreadsheet | File | FormData | Obligatorio | Archivo binario de la hoja de cálculo fuente (por ejemplo, .xlsx, .xls). Ejemplo: myWorkbook.xlsx. |
| worksheet | String | Query | Obligatorio | Nombre de la hoja de cálculo que se va a convertir (distingue mayúsculas/minúsculas). Si se omite, se utiliza la primera hoja. Ejemplo: Sheet1. |
| outPath | String | Query | Opcional | Ruta de la carpeta de destino en el almacenamiento en la nube donde se guardará el CSV generado. Si se omite, el CSV se devuelve directamente en el flujo de respuesta. |
| outStorageName | String | Query | Opcional | Nombre del servicio de almacenamiento (por ejemplo, Azure, AWS S3) donde se debe colocar el archivo de salida. Obligatorio solo si se usa outPath. |
| fontsLocation | String | Query | Opcional | Ruta a una carpeta personalizada de fuentes en el servidor, lo que permite al motor de conversión usar fuentes no estándar. |
| region | String | Query | Opcional | Identificador regional que influye en el formato de números y fechas en el CSV (por ejemplo, es-ES, fr-FR). |
| password | String | Query | Opcional | Contraseña para abrir una hoja de cálculo protegida. Debe coincidir con la contraseña de cifrado del archivo fuente. |
Respuesta
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
Códigos de estado HTTP
| Código | Significado | Descripción |
|---|---|---|
| 200 | OK (Correcto) | Filtro aplicado correctamente; la respuesta contiene los detalles de la operación. |
| 400 | Petición incorrecta | Parámetros faltantes o no válidos (por ejemplo, tipo de archivo no admitido). |
| 401 | No autorizado | Token JWT inválido o faltante. |
| 413 | Carga demasiado grande | El archivo cargado supera el límite de tamaño. |
| 500 | Error interno del servidor | Error inesperado del servidor. |
¿Cuándo usar la API para convertir hoja de cálculo a CSV?
- Extracción de datos para pipelines de BI – Extraer una hoja específica de un informe de Excel e integrar directamente el CSV resultante en Power BI o Tableau sin manipulación intermedia de archivos.
- Procesamiento automatizado de facturas – Convertir la hoja que contiene filas de facturas a CSV para una importación rápida en sistemas contables.
- Integración con sistemas heredados – Exportar datos de hojas de cálculo a CSV para su uso por aplicaciones más antiguas que solo aceptan archivos de texto delimitado.
- Generación de informes sobre la marcha – Generar instantáneas CSV de datos de hojas de cálculo en tiempo real desde un servicio web, devolviendo el archivo al navegador del cliente de inmediato.
¿Por qué usar la API para convertir hoja de cálculo a CSV?
- No se requiere almacenamiento permanente en la nube – El archivo se transmite directamente al motor de conversión y se descarta tras la conversión, ahorrando ancho de banda y costos de almacenamiento.
- Ejecución en la nube de alto rendimiento – La conversión se ejecuta en los servidores optimizados de Aspose, generalmente completándose en menos de 2 segundos para archivos de hasta 100 MB.
- Control detallado – Seleccione una única hoja, aplique fuentes personalizadas, formato regional y protección con contraseña en una sola solicitud.
- Salida coherente multiplataforma – Garantiza una salida CSV idéntica en .NET, Java, Python y otros SDK que usan el mismo endpoint REST.
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 ejecutar interacciones REST directamente desde un navegador web.
Puede usar 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.
Uso de los SDK de Aspose.Cells Cloud
El uso del SDK simplifica el desarrollo al ocultar los detalles de bajo nivel, permitiéndole fusionar una hoja de cálculo en otra con código conciso. 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 interactuar con los servicios web de Aspose.Cells usando diversos SDK: