Тариф и остаток

GEThttps://pdfapi.ru/api/v1/me

Тариф, расход и остаток страниц в текущем периоде, лимит частоты и границы периода. Страниц не тратит — подходит для мониторинга и cron.

Авторизация

Ключ из кабинета в заголовке Authorization: Bearer pdf_live_… или X-API-Key: pdf_live_…. Лимит частоты считается на ключ.

Ответы

Тело
user_idstring, uuid
Идентификатор аккаунта.
planstring
Действующий тариф: истёкший платный — уже free.
Значения:
freepremiumbusiness
periodstring, date
Дата начала периода. Устарело — используйте period_start.
period_startstring, date-time
Начало периода, UTC.
period_endstring, date-time
Когда счётчик страниц начнётся с нуля, UTC.
usageobject
Расход в текущем периоде.
pages_usedinteger
Использовано страниц.
pages_limitinteger
Лимит страниц.
pages_remaininginteger
Осталось страниц.
limitsobject
Лимит частоты ключа.
requests_per_secondinteger
Запросов в секунду.
burstinteger
Сколько запросов можно подряд, разом.
missing_api_key

— нет заголовка Authorization: Bearer … и X-API-Key
invalid_api_key

— ключ неверный или отозван
Тело
errorstringобязательное
Код ошибки — по нему стоит ветвиться в коде.
Пример:
"quota_exceeded"
messagestring
Текст по-русски — для журнала и человека.
Пример:
"Лимит страниц исчерпан"
rate_limit_exceeded

— запросы чаще лимита тарифа; повторите через Retry-After секунд
Заголовки
Retry-Afterinteger
Через сколько секунд можно повторить.
Пример:
3
Тело
errorstringобязательное
Код ошибки — по нему стоит ветвиться в коде.
Пример:
"quota_exceeded"
messagestring
Текст по-русски — для журнала и человека.
Пример:
"Лимит страниц исчерпан"

Запрос

cURL

curl https://pdfapi.ru/api/v1/me \
  -H "Authorization: Bearer $PDFAPI_KEY"

Ответ

http

HTTP/1.1 200 OK
Content-Type: application/json

{
  "user_id": "4051d4cc-4ed2-494d-812b-088fc3ac23d3",
  "plan": "premium",
  "period": "2026-10-10",
  "period_start": "2026-10-10T08:30:00.000Z",
  "period_end": "2026-11-10T08:30:00.000Z",
  "usage": {
    "pages_used": 1250,
    "pages_limit": 10000,
    "pages_remaining": 8750
  },
  "limits": {
    "requests_per_second": 10,
    "burst": 30
  }
}

Попробовать

Ключ API — не сохраняется