Convertir Excel a JSON usando la API de Aspose.Cells Cloud – Guía rápida

API REST

Esta API REST convierte un archivo de hoja de cálculo en un archivo con formato JSON.

POST https://api.aspose.cloud/v3.0/cells/convert/json

Seguridad y autenticación

Las API de Aspose.Cells Cloud son seguras y requieren autenticación basada en token JWT.

Solicitud

Parámetros de consulta

Nombre del parámetro Tipo Descripción
password string Contraseña necesaria para abrir el archivo de Excel (opcional).
storageName string Nombre del almacenamiento donde se encuentra el archivo (opcional).
checkExcelRestriction bool Aplica restricciones específicas de Excel al modificar celdas (opcional).

Parámetro del cuerpo de la solicitud

Nombre del parámetro Tipo Descripción
datafile file El archivo de Excel que se va a cargar. Debe enviarse como la primera parte de una solicitud multipart/form-data.

Ejemplo de llamada con cURL

curl -X POST "https://api.aspose.cloud/v3.0/cells/convert/json" \
     -H "Authorization: Bearer $ACCESS_TOKEN" \
     -H "accept: application/json" \
     -H "Content-Type: multipart/form-data" \
     -F "File=@myWorkbook.xlsx"

Respuesta

El servicio devuelve un objeto FileInfo. Los campos más importantes se describen a continuación:

Campo Tipo Descripción
Filename string Nombre del archivo JSON generado (por ejemplo, myWorkbook.json).
FileSize integer Tamaño del archivo generado en bytes.
FileContent string Contenido del archivo JSON en codificación Base64. Decodifíquelo para obtener el JSON real.

Ejemplo de respuesta

{
  "Filename": "myWorkbook.json",
  "FileSize": 8423,
  "FileContent": "eyJmb3JtYXR0ZWRfZGF0YSI6IH ... (cadena en base64) ..."
}

Manejo de errores

Si la solicitud falla, la API devuelve un objeto de error con la siguiente estructura:

Campo Tipo Descripción
Code string Identificador legible por máquinas del error.
Message string Descripción legible por humanos del error.

Códigos de estado HTTP comunes:

  • 400 – Solicitud incorrecta (por ejemplo, archivo faltante o parámetros no válidos).
  • 401 – No autorizado (token de acceso no válido o faltante).
  • 500 – Error interno del servidor.

Códigos de estado HTTP

Código Significado Descripción
200 OK 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 no válido o faltante.
413 Carga 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 PostConvertWorkbookToJson con SDK

Especificación de la API PostConvertWorkbookToJson

La Especificación OpenAPI define una interfaz de programación accesible públicamente y permite 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 mediante cURL.

Utilizar los SDK de Aspose.Cells Cloud

Usar un SDK es la mejor forma de acelerar el desarrollo. Un SDK se encarga de los detalles de bajo nivel, para que usted pueda centrarse en las tareas de su proyecto. Consulte el repositorio de GitHub para ver una lista completa de los SDK de Aspose.Cells Cloud.

Los siguientes ejemplos de código muestran cómo realizar llamadas a los servicios web de Aspose.Cells utilizando diversos SDK:

Otras API que implementan funcionalidades similares

  • POST /cells/{name}/saveAs – Guarda un archivo de Excel como archivo HTML con configuraciones adicionales y almacena el resultado en el almacenamiento especificado.
  • PUT /cells/convert – Convierte un archivo de Excel en archivo HTML con configuraciones adicionales y devuelve el resultado en la respuesta.
  • GET /cells/{name} – Recupera un archivo de Excel; puede usarse con parámetros de consulta para obtener el archivo en formato HTML.