Блиц-старт

Всего пять минут, начиная с регистрации и заканчивая первым PDF-файлом. Потребуется только терминал или язык программирования, который умеет отправлять HTTP-запросы.

Зарегистрируйтесь и подтвердите почту#

Создайте аккаунт и перейдите по ссылке из письма. Бесплатный тариф даёт 100 страниц в месяц без карты — для проверки этого хватит с запасом.

Выпустите ключ#

В кабинете нажмите «Выпустить ключ» и скопируйте его. Полный ключ показывается один раз: мы храним только его хеш и восстановить ключ не сможем.

Рекомендуем держать ключ в переменной окружения, а не в коде:

bash

export PDFAPI_KEY=pdf_live_...

Все библиотеки pdfapi берут ключ из PDFAPI_KEY автоматически.

Отправьте первый запрос#

cURL

curl -X POST https://pdfapi.ru/api/v1/convert \
  -H "Authorization: Bearer $PDFAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source":"html","html":"<h1>Привет, PDF</h1>"}' \
  -o hello.pdf

Проверьте результат#

Откройте hello.pdf. На бесплатном тарифе на страницах будет водяной знак, на платных он отсутствует.

Сколько страниц списано и сколько осталось, видно в заголовках ответа (или в личном кабинете), так что второй запрос за остатком не нужен:

http

HTTP/1.1 200 OK
Content-Type: application/pdf
X-Pages-Rendered: 1
X-Quota-Limit: 100
X-Quota-Used: 1
X-Quota-Remaining: 99

Что дальше#

Параметры страницы

Размер листа, поля, ориентация и ожидание скриптов.

Ошибки и повторы

Что вернёт API, когда что-то пошло не так, и что с этим делать.

Счёт из HTML-шаблона

Полный пример: шаблон, экранирование данных, поля страницы.

Попробовать в браузере

Отправить запрос со своим ключом прямо из справочника.