Conversión de archivos – Aspose.HTML Cloud

Este artículo explica cómo convertir archivos utilizando la API de Aspose.HTML Cloud en modos sincrónico y asincrónico. Si bien este ejemplo demuestra la conversión de HTML a PDF, la API admite muchos otros formatos. Puede convertir entre los siguientes formatos simplemente cambiando la ruta de la URL:

Convertidor HTML: Convierte HTML a PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP, GIF, Markdown y MHTML.
Convertidor EPUB: Convierte EPUB a PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP y GIF.
Convertidor MHTML: Convierte MHTML a PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP y GIF.
Convertidor Markdown: Convierte Markdown a PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP y GIF.
Convertidor XHTML: Convierte XHTML a PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP y GIF.
Convertidor SVG: Convierte SVG a PDF, XPS, JPEG, PNG, TIFF, BMP y GIF.
Vectorización de imágenes: Convierte imágenes rasterizadas a formatos vectoriales como SVG.

Antes de comenzar, asegúrese de haber obtenido un token de autorización. Consulte la Guía de autorización para más información.

Métodos de conversión de archivos

Aspose.HTML Cloud ofrece dos métodos para la conversión de archivos:

Conversión sincrónica: Adecuada para archivos pequeños, donde la solicitud de conversión devuelve el archivo convertido directamente en la respuesta.
Conversión asincrónica: Ideal para archivos grandes, donde la conversión se ejecuta en segundo plano, y puede descargar el archivo una vez que el proceso se haya completado.

1. Conversión sincrónica de archivos

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

Autorización: Token Bearer

Cuerpo de la solicitud:

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

Respuesta: La API devuelve el archivo convertido directamente.

 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. Conversión asincrónica de archivos

Pasos:

Enviar solicitud de conversión
Verificar estado de la conversión
Descargar el archivo convertido

 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        // Enviar solicitud de conversión
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("Solicitud de conversión enviada: " + responseData);
22
23        // La respuesta de ejemplo contiene ID como CN-a902f0ab-6d67-4847-93b3-9d90826f7ead
24        string conversionId = "CN-a902f0ab-6d67-4847-93b3-9d90826f7ead";
25
26        // Verificar estado de la conversión
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("Estado de la conversión: " + statusContent);
30
31        // Descargar el archivo convertido si el estado está completado
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("Archivo descargado como 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    // Enviar solicitud de conversión
 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("Solicitud de conversión enviada: ", conversionData);
19    const conversionId = conversionData.id;
20
21    // Verificar estado de la conversión
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("Estado de la conversión: ", statusData);
30
31    // Descargar el archivo convertido
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}

Ver también

Descripción general de la API REST Convertir desde Base64