Generar informes de Excel con plantillas de marcadores inteligentes – Guía de la API de Aspose.Cells Cloud
Esta API REST crea un libro de cálculo utilizando una plantilla de marcador inteligente.
API SmartMarker para libros de cálculo
POST https://api.aspose.cloud/v3.0/cells/{name}/smartmarker
Seguridad y autenticación
Las API de Aspose.Cells Cloud son seguras y requieren autenticación basada en token JWT.
¿Qué es un marcador inteligente?
Un marcador inteligente es una sintaxis de marcador de posición que asigna campos de datos en un archivo XML (o JSON) a celdas de una plantilla de Excel. En tiempo de ejecución, Aspose.Cells reemplaza los marcadores con los datos correspondientes, permitiéndole generar informes completamente rellenados de forma programática.
Parámetros de consulta
| Nombre del parámetro | Tipo | Descripción |
|---|---|---|
| outPath | string | Ruta de destino donde se guardará el libro generado. |
| folder | string | Carpeta que contiene el libro original. |
| storageName | string | Nombre del servicio de almacenamiento a utilizar. |
Parámetro del cuerpo de solicitud
| Nombre del parámetro | Tipo | Descripción |
|---|---|---|
| xmlFile | file | Archivo XML con datos del marcador inteligente subido con la solicitud. |
Respuesta
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
Notas / Limitaciones:
- La API admite archivos de Excel de hasta 50 MB.
- Los formatos aceptados son únicamente .xlsx, .xlsm y .xlsb.
- Se aplica un límite de velocidad de 20 solicitudes por segundo por cuenta.
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 inválido o ausente. |
| 413 | Carga útil demasiado grande | El archivo subido supera el límite de tamaño. |
| 500 | Error interno del servidor | Error inesperado en el servidor. |
Cómo usar la API SmartMarker para libros de cálculo
Especificación de la API SmartMarker para libros de cálculo
La Especificación OpenAPI define una interfaz de programación accesible públicamente y le permite realizar interacciones REST directamente desde un navegador web.
Uso de los SDK de Aspose.Cells Cloud
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.
Ejemplo rápido en una sola línea
curl -X POST "https://api.aspose.cloud/v3.0/cells/{name}/smartmarker?outPath={outPath}" -H "Authorization: Bearer {access_token}" -F "xmlFile=@Sample_SmartMarker_Data.xml"
Manejo de errores
| Código de estado HTTP | Descripción | Causa típica |
|---|---|---|
| 400 | Solicitud incorrecta | Plantilla ausente, XML con formato incorrecto o parámetros no válidos. |
| 401 | No autorizado | Token de autenticación inválido o ausente. |
| 404 | No encontrado | El libro especificado o la ubicación del almacenamiento no existe. |
| 500 | Error interno del servidor | Fallo inesperado del lado del servidor. |
Ejemplo de respuesta de error (400)
{
"Code": 400,
"Message": "El archivo de datos XML está ausente o tiene un formato incorrecto."
}
Familia de SDK en la nube
Utilizar un SDK es la mejor forma de acelerar el desarrollo. Un SDK maneja los detalles de bajo nivel para que usted se enfoque en las tareas de su proyecto. 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 mediante diversos SDK: