
Выполните преобразование HTML в PDF с использованием SDK Node.js.
Конвертирование HTML файлов или веб-страниц в PDF является необходимым для создания печатных документов, сохранения макетов и архивирования контента в портативном формате. Используя GroupDocs.Conversion Cloud SDK для Node.js, вы можете автоматизировать этот процесс через REST API без необходимости в сторонних инструментах или зависимостях от браузера.
В этой статье вы узнаете, как:
- 🌐 API для конвертации HTML в PDF для Node.js
- 🚀 Конвертировать HTML в PDF с помощью Node.js
- 💻 Конвертировать HTML в PDF с помощью cURL
🌐 API для конвертации HTML в PDF для Node.js
GroupDocs.Conversion Cloud SDK for Node.js позволяет высококачественное, масштабируемое преобразование из формата HTML в PDF, сохраняя дизайн, макет и встроенные медиа.
📦 Установите SDK
Установите с помощью npm:
npm install groupdocs-conversion-cloud --save
Убедитесь, что у вас есть ваш персонализированный Client ID и Client Secret из GroupDocs Cloud Dashboard. Для получения дополнительной информации вы можете рассмотреть возможность посещения этого tutorial.
🚀 Конвертация HTML в PDF с использованием Node.js
Вот пошаговое руководство по конвертированию PDF-документа в HTML с использованием Node.js:
📌 Шаг 1: Импортируйте SDK и настройте API:
const { Configuration, ConvertApi, FileApi, UploadFileRequest, ConvertSettings, ConvertDocumentRequest } = require("groupdocs-conversion-cloud");
const config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
const convertApi = new ConvertApi(config);
const fileApi = new FileApi(config);
📌 Шаг 2: Загрузите входной HTML файл в облачное хранилище:
const fs = require("fs");
const uploadRequest = new UploadFileRequest("input.html", fs.createReadStream("input.html"));
await fileApi.uploadFile(uploadRequest);
📌 Шаг 3: Установите параметры конвертации HTML в PDF:
const settings = new ConvertSettings();
settings.filePath = "input.html";
settings.format = "pdf";
settings.outputPath = "converted/output.pdf";
const request = new ConvertDocumentRequest(settings);
await convertApi.convertDocument(request);
console.log("✅ The HTML successfully converted to PDF.");
// Более примеров на https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// Получите свои учетные данные API
string clientId = "XXXXXX-XXXXXXXXX-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";
// Создайте экземпляр класса Configuration и инициализируйте его с помощью Client ID и Client Secret
Configuration configuration = new Configuration(clientId, clientSecret);
// Определите базовый URL API для выполнения онлайн-преобразования PDF в HTML
configuration.setApiBaseUrl("https://api.groupdocs.cloud");
// Инициализируйте экземпляр ConvertApi с объектом Configuration
ConvertApi convertApi = new ConvertApi(configuration);
ConvertSettings settings = new ConvertSettings();
settings.setStorageName("internal");
settings.setFilePath("input.html");
settings.setFormat("PDF");
settings.setOutputPath("resultant.pdf");
// Используйте метод ConvertDocument для конвертации HTML в формат PDF.
ConvertDocumentRequest request = new ConvertDocumentRequest(settings);
List<StoredConvertedResult> response = convertApi.convertDocument(request);
// Check the response and print success message
if (response != null && response.equals("OK")) {
System.out.println("The HTML file is successfully converted PDF! The Resultant PDF file is saved at: " + response.getFilePath());
}

Изображение:- Предварительный просмотр конвертации HTML в PDF.
Скачайте пример PDF файла, сгенерированного в приведенном выше примере, с resultant.pdf.
💻 Преобразовать HTML в PDF с помощью cURL
Вы предпочитаете CLI? Вы также можете конвертировать HTML в PDF, используя cURL с GroupDocs.Conversion Cloud API.
- ✅ Этот метод идеален для автоматизационных конвейеров и конверсий на основе скриптов.
Шаг 1: Получите JWT Access Token
curl -v "https://api.groupdocs.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET" \
-H "Content-Type: application/x-www-form-urlencoded"
Шаг 2: Преобразование HTML в PDF
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourcePDF}\", \"Format\": \"html\", \"OutputPath\": \"{finalOutput}\"}"
Замените sourceFile, resultantFile и accessToken на реальные значения.
- Теперь, чтобы сохранить PDF на локальном диске, вы можете рассмотреть возможность использования следующей команды cURL:
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourceFile}\", \"Format\": \"html\"}" \
-o "myOutput.html"
🧪 Попробуйте бесплатный онлайн-конвертер HTML в PDF
Хотите быстрое решение без кода? Используйте HTML to PDF Converter, чтобы мгновенно преобразовать веб-контент.

✅ Заключение
С помощью GroupDocs.Conversion Cloud SDK для Node.js вы можете быстро и надежно конвертировать HTML в PDF — идеально подходит для разработчиков, создающих функции автоматизации документов или экспортирующих стилизованный HTML-контент в PDF.
Независимо от того, интегрируете ли вы это в бэкенд на Node.js или используете его через cURL, этот API предлагает гибкость и контроль.
🔗 Полезные ресурсы
📚 Рекомендуемые статьи
Мы рекомендуем изучить следующие статьи: