File Conversion – Aspose.HTML Cloud

This article explains how to convert 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.

File Conversion Methods

Aspose.HTML Cloud offers two methods for 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.

1. Synchronous File Conversion

Endpoint: POST https://api.aspose.cloud/v4.0/html/conversion/html-pdf/sync

Authorization: Bearer token

Request Body:

1{
2    "InputPath": "http://help.websiteos.com/websiteos/example_of_a_simple_html_page.htm"
3}

Response: The API returns the converted file directly.

 1using System;
 2using System.IO;
 3using System.Net.Http;
 4using System.Net.Http.Headers;
 5using System.Text;
 6using System.Threading.Tasks;
 7
 8public async Task ConvertFileSync()
 9{
10    using (HttpClient client = new HttpClient())
11    {
12        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_ACCESS_TOKEN");
13        var requestBody = new StringContent(
14            "{\"InputPath\": \"http://help.websiteos.com/websiteos/example_of_a_simple_html_page.htm\"}",
15            Encoding.UTF8, "application/json");
16        var response = await client.PostAsync("https://api.aspose.cloud/v4.0/html/conversion/html-pdf/sync", requestBody);
17        var fileStream = await response.Content.ReadAsStreamAsync();
18        using (FileStream fs = new FileStream("output.pdf", FileMode.Create))
19        {
20            await fileStream.CopyToAsync(fs);
21        }
22    }
23}

JavaScript

 1async function convertFileSync() {
 2    const url = "https://api.aspose.cloud/v4.0/html/conversion/html-pdf/sync";
 3    const requestBody = JSON.stringify({ "InputPath": "http://help.websiteos.com/websiteos/example_of_a_simple_html_page.htm" });
 4    const response = await fetch(url, {
 5        method: 'POST',
 6        headers: {
 7            'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
 8            'Content-Type': 'application/json'
 9        },
10        body: requestBody
11    });
12    const blob = await response.blob();
13    const a = document.createElement('a');
14    a.href = URL.createObjectURL(blob);
15    a.download = 'output.pdf';
16    a.click();
17}

2. Asynchronous File Conversion

Steps:

Submit conversion request
Check conversion status
Download the converted file

 1using System;
 2using System.IO;
 3using System.Net.Http;
 4using System.Net.Http.Headers;
 5using System.Text;
 6using System.Threading.Tasks;
 7
 8public async Task ConvertFileAsync()
 9{
10    using (HttpClient client = new HttpClient())
11    {
12        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_ACCESS_TOKEN");
13
14        // Submit conversion request
15        var requestBody = new StringContent(
16            "{\"InputPath\": \"https://example.com\", \"OutputFile\": \"test.pdf\"}",
17            Encoding.UTF8, "application/json");
18
19        var response = await client.PostAsync("https://api.aspose.cloud/v4.0/html/conversion/html-pdf", requestBody);
20        var responseData = await response.Content.ReadAsStringAsync();
21        Console.WriteLine("Conversion Request Submitted: " + responseData);
22
23        // Example response contains ID like CN-a902f0ab-6d67-4847-93b3-9d90826f7ead
24        string conversionId = "CN-a902f0ab-6d67-4847-93b3-9d90826f7ead";
25
26        // Check conversion status
27        HttpResponseMessage statusResponse = await client.GetAsync($"https://api.aspose.cloud/v4.0/html/conversion/{conversionId}");
28        string statusContent = await statusResponse.Content.ReadAsStringAsync();
29        Console.WriteLine("Conversion Status: " + statusContent);
30
31        // Download the converted file if status is completed
32        HttpResponseMessage downloadResponse = await client.GetAsync($"https://api.aspose.cloud/v4.0/html/conversion/{conversionId}/download");
33        using (FileStream fs = new FileStream("output.pdf", FileMode.Create))
34        {
35            await downloadResponse.Content.CopyToAsync(fs);
36        }
37        Console.WriteLine("File downloaded as output.pdf");
38    }
39}

JavaScript

 1async function convertFileAsync() {
 2    const token = "YOUR_ACCESS_TOKEN";
 3    const conversionUrl = "https://api.aspose.cloud/v4.0/html/conversion/html-pdf";
 4    const statusUrl = "https://api.aspose.cloud/v4.0/html/conversion/";
 5
 6    // Submit conversion request
 7    const requestBody = JSON.stringify({ "InputPath": "https://example.com", "OutputFile": "test.pdf" });
 8    let response = await fetch(conversionUrl, {
 9        method: 'POST',
10        headers: {
11            'Authorization': `Bearer ${token}`,
12            'Content-Type': 'application/json'
13        },
14        body: requestBody
15    });
16
17    const conversionData = await response.json();
18    console.log("Conversion Request Submitted: ", conversionData);
19    const conversionId = conversionData.id;
20
21    // Check conversion status
22    response = await fetch(`${statusUrl}${conversionId}`, {
23        method: 'GET',
24        headers: {
25            'Authorization': `Bearer ${token}`
26        }
27    });
28
29    const statusData = await response.json();
30    console.log("Conversion Status: ", statusData);
31
32    if (statusData.status === 'completed') {
33        // Download the converted file
34        response = await fetch(`${statusUrl}${conversionId}/download`, {
35            method: 'GET',
36            headers: {
37                'Authorization': `Bearer ${token}`
38            }
39        });
40
41        const blob = await response.blob();
42        const a = document.createElement('a');
43        a.href = URL.createObjectURL(blob);
44        a.download = 'output.pdf';
45        a.click();
46        console.log("File downloaded as output.pdf");
47    }
48}

File Conversion – Aspose.HTML Cloud

File Conversion Methods

1. Synchronous File Conversion

2. Asynchronous File Conversion

See Also