Agregar una fila vacía a una hoja de cálculo de Excel utilizando la API de Aspose.Cells Cloud

Esta API REST agrega una nueva fila a una hoja de cálculo de Excel. Inserta una fila vacía en el índice especificado, el cual es de base cero.

Requisitos previos:

Debe incluirse un token de acceso válido de Aspose Cloud (Bearer JWT) en el encabezado Authorization.
El libro de trabajo objetivo debe cargarse en su almacenamiento de Aspose Cloud, y los parámetros folder y storageName deben apuntar a su ubicación.

Notas:

El rowIndex es de base cero; insertar en el índice 0 agrega una fila al inicio de la hoja de cálculo.
Las hojas de cálculo de Excel tienen un máximo de 1 048 576 filas; intentar insertar más allá de este límite resultará en un error.

API PutInsertWorksheetRow

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/{rowIndex}

Seguridad y autenticación

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

Parámetros de la solicitud

Nombre del parámetro	Tipo	Ubicación	Descripción
name	string	path	Nombre del archivo del libro de trabajo.
sheetName	string	path	Nombre de la hoja de cálculo.
rowIndex	integer	path	Índice de base cero donde se insertará la nueva fila.
folder	string	query	Ruta de la carpeta en el almacenamiento que contiene el libro.
storageName	string	query	Nombre del almacenamiento de Aspose Cloud a utilizar.

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

Solicitud

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/10" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Nota: Todos los puntos finales de Aspose.Cells Cloud requieren HTTPS. Utilice el esquema seguro https:// para llamadas en producción.

Respuesta

{
  "Code": 200,
  "Status": "OK"
}

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 inválidos (por ejemplo, tipo de archivo no admitido).
401	No autorizado	Token JWT inválido o faltante.
413	Payload demasiado grande	El archivo cargado excede el límite de tamaño.
500	Error interno del servidor	Error inesperado en el servidor.

Ejemplo de una respuesta de error (por ejemplo, cuando el índice de fila excede el límite de la hoja de cálculo):

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "Índice de fila fuera de rango. Número máximo de filas permitidas: 1048576."
}

Familia de SDK en la nube

Utilizar un SDK es la mejor forma de acelerar el desarrollo. Un SDK abstrae los detalles de bajo nivel, permitiéndole centrarse 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: