API Helper Buh

Программный доступ к распознаванию документов. Ключ создаётся в личном кабинете. Списание с баланса: цена за страницу (как в веб-версии).

Авторизация

X-API-Key: hb_ваш_ключ

# или
Authorization: Bearer hb_ваш_ключ

Эндпоинты

GET /api/v1/me

Организация и баланс по ключу

GET /api/v1/billing/balance

Текущий баланс

GET /api/v1/billing/pricing

Цена за страницу

POST /api/v1/documents/upload

Загрузить один PDF/изображение (синхронно)

POST /api/v1/documents/upload/batch

Пакетная загрузка (фон), затем опрос status

GET /api/v1/documents

Список документов

GET /api/v1/documents/{id}/status

Статус обработки

GET /api/v1/documents/{id}/json

Результат распознавания JSON

GET /api/v1/documents/{id}/xml

Результат XML

Пример curl

# Баланс
curl -H "X-API-Key: hb_..." https://helper-buh.ru/api/v1/billing/balance

# Загрузка документа
curl -H "X-API-Key: hb_..." \
  -F "file=@invoice.pdf" \
  https://helper-buh.ru/api/v1/documents/upload

# Статус
curl -H "X-API-Key: hb_..." \
  https://helper-buh.ru/api/v1/documents/123/status

# JSON результат
curl -H "X-API-Key: hb_..." \
  https://helper-buh.ru/api/v1/documents/123/json

Где брать ключ

Кабинет → блок «API для интеграций» → «Создать ключ». Полный ключ hb_... показывается один раз.