Advanced Convert Excel File – Aspose.Cells Cloud API Guide

Advanced Cloud API for Excel Conversion

The Advanced Convert operation enables you to transform an Excel workbook into various output formats (PDF, HTML, CSV, etc.) while giving you fine‑grained control over page setup, save options, and print settings.

Prerequisites / Authentication
To use this endpoint you must obtain an access token from Aspose.Cells Cloud and include it in the Authorization header as a Bearer token.

API Reference

  • Method: PUT
  • Endpoint: /cells/convert
  • Parameters:
    • format (string, required) – Desired output format (e.g., pdf, html).
    • outPath (string, optional) – Path in cloud storage where the converted file will be saved.
    • options (object, optional) – JSON object containing advanced conversion options such as pageSetup, saveOptions, and printSettings.
  • Request Body Example: 
    {
  "format": "pdf",
  "outPath": "output/converted.pdf",
  "options": {
    "pageSetup": {
      "orientation": "Landscape",
      "paperSize": "A4"
    },
    "saveOptions": {
      "compress": true
    },
    "printSettings": {
      "printHeadings": false
    }
  }
}
  • Response:
    • 200 OK – Conversion succeeded; response contains the converted file stream or a reference to the saved file.
    • 400 Bad Request – Invalid parameters or malformed request body.
    • 401 Unauthorized – Authentication failed or token missing.
    • 500 Internal Server Error – Server‑side error during conversion.

HTTP Status Codes

Code Meaning Description
200 OK Filter applied successfully; response contains operation details.
400 Bad Request Missing or invalid parameters (e.g., unsupported file type).
401 Unauthorized Invalid or missing JWT token.
413 Payload Too Large Uploaded file exceeds size limit.
500 Internal Server Error Unexpected server error.

Notes

  • Some output formats have specific limitations (e.g., HTML conversion does not preserve macros). Review the format‑specific documentation for details.

The ability to load spreadsheet files from multiple data sources

Set Page Setup and Save Options

Cloud SDK Family

Using an SDK helps accelerate development by handling low‑level details, allowing you to focus on your project tasks. Please check out the GitHub repository for a complete list of Aspose.Cells Cloud SDKs.

The following code examples demonstrate how to make calls to Aspose.Cells web services using various SDKs:

Convert Excel to HTML Save Options