Dateikonvertierung – Aspose.HTML Cloud

Dieser Artikel erklärt, wie Sie Dateien mit der Aspose.HTML Cloud API sowohl im synchronen als auch im asynchronen Modus konvertieren können. Während dieses Beispiel die Konvertierung von HTML zu PDF demonstriert, unterstützt die API viele andere Formate. Sie können zwischen den folgenden Formaten konvertieren, indem Sie einfach den URL-Pfad ändern:

HTML-Konverter: Konvertieren Sie HTML zu PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP, GIF, Markdown und MHTML.
EPUB-Konverter: Konvertieren Sie EPUB zu PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP und GIF.
MHTML-Konverter: Konvertieren Sie MHTML zu PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP und GIF.
Markdown-Konverter: Konvertieren Sie Markdown zu PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP und GIF.
XHTML-Konverter: Konvertieren Sie XHTML zu PDF, XPS, DOCX, JPEG, PNG, TIFF, BMP und GIF.
SVG-Konverter: Konvertieren Sie SVG zu PDF, XPS, JPEG, PNG, TIFF, BMP und GIF.
Bild-Vektorisierung: Konvertieren Sie Rasterbilder in Vektorformate wie SVG.

Stellen Sie vor dem Start sicher, dass Sie ein Autorisierungstoken erhalten haben. Weitere Informationen finden Sie im Autorisierungsleitfaden.

Dateikonvertierungsmethoden

Aspose.HTML Cloud bietet zwei Methoden zur Dateikonvertierung:

Synchrone Konvertierung: Geeignet für kleine Dateien, bei denen die Konvertierungsanfrage die konvertierte Datei direkt in der Antwort zurückgibt.
Asynchrone Konvertierung: Ideal für große Dateien, bei denen die Konvertierung im Hintergrund ausgeführt wird und Sie die Datei herunterladen können, sobald der Prozess abgeschlossen ist.

1. Synchrone Dateikonvertierung

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

Autorisierung: Bearer-Token

Anfragekörper:

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

Antwort: Die API gibt die konvertierte Datei direkt zurück.

 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. Asynchrone Dateikonvertierung

Schritte:

Konvertierungsanfrage einreichen
Konvertierungsstatus überprüfen
Die konvertierte Datei herunterladen

 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}

Siehe auch

REST API Übersicht Konvertierung aus Base64