Документация API

Назначение: API позволяет сервисам подключаться к единому биллингу и работать с балансом пользователей централизованно.

Принцип: получите JWT после регистрации/входа и отправляйте его в заголовке Authorization: Bearer TOKEN для защищенных методов.

Базовые принципы

Формат ответов: JSON.
Авторизация: JWT Bearer token.
Деньги хранятся как RUB с точностью 2 знака.
Для пополнений поддерживается idempotency key.

Endpoints

Метод	URL	Назначение
POST	`/auth/register`	Регистрация пользователя
POST	`/auth/login`	Вход и получение JWT
GET	`/auth/me`	Профиль текущего пользователя
GET	`/balance`	Текущий баланс кошелька
GET	`/transactions`	История транзакций
POST	`/deposit`	Создать платеж на пополнение
POST	`/charge`	Списание за услугу (для серверов сервисов)
POST	`/webhook/yookassa`	Webhook от YooKassa

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

1) Регистрация

curl -X POST https://dengivot.ru/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com","password":"StrongPass123"}'

2) Баланс (с токеном)

curl https://dengivot.ru/balance \
  -H "Authorization: Bearer TOKEN"

3) Списание за сервис

curl -X POST https://dengivot.ru/charge \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer TOKEN" \
  -d '{"amount":10.00,"service":"video-ai"}'