Local File Conversion – Aspose.HTML Cloud

This article explains how to convert local files using Aspose.HTML Cloud API in both synchronous and asynchronous modes. While this example demonstrates converting HTML to PDF, the API supports many other formats. You can convert between the following formats by simply changing the URL path:

HTML Converter: Convert HTML to PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP, GIF, Markdown, and MHTML.
EPUB Converter: Convert EPUB to PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP, and GIF.
MHTML Converter: Convert MHTML to PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP, and GIF.
Markdown Converter: Convert Markdown to PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP, and GIF.
XHTML Converter: Convert XHTML to PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP, and GIF.
SVG Converter: Convert SVG to PDF, XPS, JPEG, PNG, TIFF, BMP, and GIF.
Image Vectorization: Convert raster images to vector formats like SVG.

Before starting, make sure you have obtained an authorization token. See Authorization Guide for more information.

Local File Conversion Process

Aspose.HTML Cloud offers two methods for local file conversion:

Synchronous Conversion: Suitable for small files, where the conversion request returns the converted file directly in the response.
Asynchronous Conversion: Ideal for large files, where the conversion runs in the background, and you can download the file once the process is completed.

Step 1: Upload Local File to Cloud Storage

Before conversion, you need to upload your local file to Aspose Cloud storage.

 1using System;
 2using System.Collections.Generic;
 3using System.IO;
 4using System.Net.Http;
 5using System.Net.Http.Headers;
 6using System.Text;
 7using System.Threading.Tasks;
 8using Newtonsoft.Json;
 9
10public class FileUploadResponse
11{
12    [JsonProperty("uploaded")]
13    public List<string> Uploaded { get; set; } = new List<string>();
14
15    [JsonProperty("errors")]
16    public List<string> Errors { get; set; } = new List<string>();
17}
18
19public async Task<FileUploadResponse> UploadHtmlFile(string token, string filePath)
20{
21    string apiUrl = "https://api.aspose.cloud/v4.0/html/file";
22
23    using (HttpClient client = new HttpClient())
24    {
25        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
26
27        using (var content = new MultipartFormDataContent())
28        using (var fileStream = new FileStream(filePath, FileMode.Open, FileAccess.Read))
29        using (var fileContent = new StreamContent(fileStream))
30        {
31            fileContent.Headers.ContentType = new MediaTypeHeaderValue("text/html");
32            content.Add(fileContent, "file", Path.GetFileName(filePath));
33
34            HttpResponseMessage response = await client.PostAsync(apiUrl, content);
35            string responseContent = await response.Content.ReadAsStringAsync();
36
37            if (response.IsSuccessStatusCode)
38            {
39                return JsonConvert.DeserializeObject<FileUploadResponse>(responseContent);
40            }
41            else
42            {
43                throw new Exception($"Error uploading file: {response.StatusCode} - {responseContent}");
44            }
45        }
46    }
47}

JavaScript

 1async function uploadHtmlFile(token, filePath) {
 2    const apiUrl = "https://api.aspose.cloud/v4.0/html/file";
 3    const file = new File([await fetch(filePath).then(res => res.blob())], "input.html", { type: "text/html" });
 4
 5    const formData = new FormData();
 6    formData.append('file', file);
 7
 8    const response = await fetch(apiUrl, {
 9        method: 'POST',
10        headers: {
11            'Authorization': `Bearer ${token}`
12        },
13        body: formData
14    });
15
16    if (!response.ok) {
17        const error = await response.text();
18        throw new Error(`Error uploading file: ${response.status} - ${error}`);
19    }
20
21    const responseData = await response.json();
22    console.log("Uploaded File Response: ", responseData);
23    return responseData.uploaded[0];
24}

Step 2: Convert Uploaded File (Sync and Async)

For synchronous and asynchronous conversion, follow the same approach as described in the File Conversion Guide, using the uploaded file path as InputPath.

Local File Conversion – Aspose.HTML Cloud

Local File Conversion Process

Step 1: Upload Local File to Cloud Storage

Step 2: Convert Uploaded File (Sync and Async)

See Also