Конвертация файлов – Aspose.HTML Cloud

В этой статье объясняется, как конвертировать файлы с использованием API Aspose.HTML Cloud в синхронном и асинхронном режимах. Хотя этот пример демонстрирует преобразование HTML в PDF, API поддерживает множество других форматов. Вы можете конвертировать между следующими форматами, просто изменив путь URL:

HTML Конвертер: Преобразует HTML в PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP, GIF, Markdown и MHTML.
EPUB Конвертер: Преобразует EPUB в PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP и GIF.
MHTML Конвертер: Преобразует MHTML в PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP и GIF.
Markdown Конвертер: Преобразует Markdown в PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP и GIF.
XHTML Конвертер: Преобразует XHTML в PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP и GIF.
SVG Конвертер: Преобразует SVG в PDF, XPS, JPEG, PNG, TIFF, BMP и GIF.
Векторизация изображений: Преобразует растровые изображения в векторные форматы, такие как SVG.

Перед началом работы убедитесь, что вы получили токен авторизации. Дополнительную информацию см. в Руководстве по авторизации.

Методы конвертации файлов

Aspose.HTML Cloud предлагает два метода конвертации файлов:

Синхронная конвертация: Подходит для небольших файлов, когда запрос на конвертацию возвращает конвертированный файл непосредственно в ответе.
Асинхронная конвертация: Идеально подходит для больших файлов, когда конвертация выполняется в фоновом режиме, и вы можете загрузить файл после завершения процесса.

1. Синхронная конвертация файлов

Конечная точка: POST https://api.aspose.cloud/v4.0/html/conversion/html-pdf/sync

Авторизация: Bearer токен

Тело запроса:

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

Ответ: API возвращает конвертированный файл напрямую.

 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. Асинхронная конвертация файлов

Шаги:

Отправить запрос на конвертацию
Проверить статус конвертации
Загрузить конвертированный файл

 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        // Отправить запрос на конвертацию
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("Запрос на конвертацию отправлен: " + responseData);
22
23        // Пример ответа содержит ID вида CN-a902f0ab-6d67-4847-93b3-9d90826f7ead
24        string conversionId = "CN-a902f0ab-6d67-4847-93b3-9d90826f7ead";
25
26        // Проверить статус конвертации
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("Статус конвертации: " + statusContent);
30
31        // Загрузить конвертированный файл, если статус завершен
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("Файл загружен как 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    // Отправить запрос на конвертацию
 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("Запрос на конвертацию отправлен: ", conversionData);
19    const conversionId = conversionData.id;
20
21    // Проверить статус конвертации
22    response = await fetch(`${statusUrl}${conversionId}`, {
23        method: 'GET',
24        headers: {
25            'Authorization': `Bearer ${token}`
26        }
27    });
28    const statusData = await response.json();
29    console.log("Статус конвертации: ", statusData);
30
31    // Загрузить конвертированный файл
32    response = await fetch(`${statusUrl}${conversionId}/download`, {
33        method: 'GET',
34        headers: {
35            'Authorization': `Bearer ${token}`
36        }
37    });
38    const blob = await response.blob();
39    const a = document.createElement('a');
40    a.href = URL.createObjectURL(blob);
41    a.download = 'output.pdf';
42    a.click();
43}

Смотрите также

Обзор REST API Конвертация из Base64