Guardar libro de Excel: API de Aspose.Cells Cloud

Esta API REST le permite guardar un archivo de Excel en distintos formatos.
Antes de llamar a este endpoint, asegúrese de tener un token de acceso OAuth 2.0 válido y de que el libro de trabajo origen esté almacenado en su almacenamiento de Aspose Cloud.

Requisitos previos

Obtenga un token de acceso JWT e inclúyalo en el encabezado Authorization: Bearer <token> de cada solicitud.
Cargue el libro de trabajo origen en el almacenamiento de Aspose Cloud (o confirme que ya existe).
Conozca el nombre del almacenamiento y la ruta de la carpeta donde se encuentra el libro de trabajo.

API PostWorkbookSaveAs

POST https://api.aspose.cloud/v3.0/cells/{name}/saveAs

Seguridad y autenticación

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

Parámetro de ruta

Nombre del parámetro	Tipo	Descripción
name	string	Nombre del archivo de Excel.

Parámetro de consulta

Nombre del parámetro	Tipo	Descripción
newfilename	string	Nuevo nombre de archivo para el documento guardado.
isAutoFitRows	string	Si es `true`, ajusta automáticamente todas las filas del libro de trabajo. El valor predeterminado es `false`.
isAutoFitColumns	string	Si es `true`, ajusta automáticamente el ancho de las columnas del libro de trabajo. El valor predeterminado es `false`.
folder	string	Carpeta que contiene el libro de trabajo original.
storageName	string	Nombre del almacenamiento donde se encuentra el archivo de origen.
outStorageName	string	Nombre del almacenamiento donde se guardará el archivo de salida.
checkExcelRestriction	bool	Especifica si se deben aplicar restricciones de Excel al modificar celdas u objetos relacionados.
region	string	Configuración regional aplicada al libro de trabajo.
pageWideFitOnPerSheet	bool	Ajusta el ancho de página a cada hoja de cálculo durante la conversión.
pageTallFitOnPerSheet	bool	Ajusta la altura de página a cada hoja de cálculo durante la conversión.
sheetName	string	Nombre de la hoja de cálculo que se va a convertir.
pageIndex	string	Índice de la página que se va a convertir dentro de la hoja especificada (requiere `sheetName`).
onePagePerSheet	bool	Al convertir a PDF, genera una página por hoja de cálculo.

Parámetro del cuerpo de solicitud

Nombre del parámetro	Tipo	Descripción
SaveOptions	Object	Opciones de guardado proporcionadas en la segunda parte de la solicitud multipart.

Ejemplo de cuerpo de solicitud (parte JSON de la solicitud multipart)

{
  "SaveOptions": {
    "SaveFormat": "pdf",
    "CompressionLevel": 9
  }
}

Respuesta

La API devuelve un objeto SaveResponse.

{
  "Status": "OK",
  "Code": 200,
  "SaveResult": {
    "Documents": [
      {
        "Name": "sample.pdf",
        "Size": 10240,
        "Folder": "output",
        "Storage": "MyStorage"
      }
    ]
  }
}

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

Cómo usar la API PostWorkbookSaveAs con SDK

Especificación de la API PostWorkbookSaveAs

La Especificación OpenAPI define una interfaz de programación accesible públicamente y le permite realizar interacciones REST directamente desde un navegador web.

Puede utilizar cURL para acceder fácilmente a los servicios web de Aspose.Cells. El ejemplo siguiente muestra cómo llamar a la API en la nube con cURL.

Solicitud

curl -X POST "https://api.aspose.cloud/v3.0/cells/sampleBook.xlsx/SaveAs?newfilename=sample.pdf&isAutoFitRows=true&isAutoFitColumns=true" \
  -H "accept: multipart/form-data" \
  -H "Authorization: Bearer <your_jwt_token>"

Respuesta

{
  "SaveResult": {
    "Documents": [
      {
        "Name": "sample.pdf",
        "Size": 10240,
        "Folder": "output",
        "Storage": "MyStorage"
      }
    ]
  },
  "Code": 200,
  "Status": "OK"
}

Utilizar los SDK de Aspose.Cells Cloud

Utilizar un SDK es la mejor manera de acelerar el desarrollo. Un SDK gestiona 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 llamar a los servicios web de Aspose.Cells mediante diversos SDK:

Para otros escenarios de conversión, consulte las guías Convertir Excel a PDF y Exportar Excel a CSV.

Conversión avanzada de archivo Excel