Конвертация HTML в PDF. Работает асинхронно: запрос ставит задачу, готовый файл сервис сам выгружает в fileStorage по переданному адресу.
POST /convert
{
"sourceUrl": "https://example.com",
"options": {
"uploadUrl": "https://fs.chatium.ru/upload/…",
"callbackUrl": "https://your-server/hook"
}
}
→ 202 { "jobId": "…", "status": "queued" }
Вместо sourceUrl можно передать html с готовой разметкой
или загрузить HTML-файл полем file (multipart).
Либо поллингом GET /jobs/:jobId, либо через options.callbackUrl —
сервис сам пришлёт результат, когда файл будет готов.
{ "id":"…", "status":"done",
"pdfUrl":"https://fs.chatium.ru/get/…",
"files":[{"name":"example.com.pdf","url":"…","sha256":"…","size":16311}],
"pages": 1 }
options.pdf)| Параметр | Значения | По умолчанию |
|---|---|---|
| format | A0–A6, Letter, Legal, Tabloid, Ledger | A4 |
| landscape | true / false | false |
| margin | 1cm, 15mm, 0.5in | без полей |
| scale | 0.1 – 2 | 1 |
| printBackground | true / false | true |
| waitUntil | networkidle2 / networkidle0 | networkidle2 |
Проверка живости: GET /health. Полное описание — в репозитории
chatium/pdf-maker, файл docs/api.md.