serverlesspdf
ВойтиНачать бесплатно
serverlesspdf
ВойтиНачать бесплатно

serverlesspdf API Reference

Интегрируйте генерацию PDF в ваш продукт за несколько минут. Единый предсказуемый API для рендера и скачивания.

Быстрый старт

Создайте аккаунт, подтвердите email, выпустите API-ключ в кабинете и отправьте запрос ниже с вашего backend.

POST /v1/documents/render

POST

Основной метод генерации PDF. Принимает HTML, CSS и настройки рендера. Возвращает готовый документ или ссылку на него.

Request Headers
Authorization: Bearer <api_key>
Content-Type: application/json
Request Body
{
  "html": "<!doctype html><html>...</html>",
  "options": {
    "pageSize": "A4",
    "landscape": false,
    "printBackground": true,
    "margin": {
      "top": "12mm",
      "right": "12mm",
      "bottom": "12mm",
      "left": "12mm"
    }
  }
}

GET /v1/documents/:documentId/download

GET

Получение сгенерированного PDF документа по его ID. При успехе маршрут возвращает redirect на короткоживущий signed URL для безопасного скачивания.

Варианты авторизации
  • Session cookie (для браузера)
  • Bearer API key (для backend-интеграций)

Формат ошибок

Все ошибки возвращаются в едином структурированном виде:

{
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Monthly limit reached",
    "requestId": "req_123abc"
  }
}

Лимиты Public Beta

  • 1 000 рендеров на окно квоты и до 30 параллельных задач.
  • HTML до 10 МБ, готовый PDF до 100 МБ и до 1 000 страниц на документ.
  • PDF доступен до 90 дней по подписанной ссылке для скачивания.

Ошибки и восстановление

  • QUOTA_EXCEEDED или CONCURRENT_LIMIT_EXCEEDED: дождитесь нового окна квоты или уменьшите параллелизм.
  • INVALID_HTML или HTML_TOO_LARGE: проверьте payload и уложитесь в ограничение размера.
  • RENDER_TIMEOUT или RENDER_ERROR: повторите попытку с более простым HTML и сохраните requestId для обращения в поддержку.