Баланс и статистика

Раздел предоставляет информацию о текущем балансе, кредитном лимите, использовании. Эндпоинты защищены HMAC‑аутентификацией (см. Аутентификация). При недостатке средств сервис может отправить вебхук transcription.low.balance — см. Вебхуки.

Баланс

Для получения текущего баланса пользователя необходимо вызвать GET /v1/billing/balance — [Контракт: getBalance]

curl -X GET https://api.transcription.aiesa.ru/api/v1/billing/balance \
  -H "X-Public-Key: <KEY>" -H "X-Timestamp: <TS>" -H "X-Signature: <SIG>"

Статистика использования

Для получения статистики пользования API необходимо вызвать GET /v1/billing/usage — [Контракт: getUsageStatistics]

Параметры запроса:

• period: current_month | last_month | last_3_months | custom (по умолчанию current_month)
• date_from: YYYY-MM-DD (при period=custom)
• date_to: YYYY-MM-DD (при period=custom)

curl -X GET "https://api.transcription.aiesa.ru/api/v1/billing/usage?period=current_month" \
  -H "X-Public-Key: <KEY>" -H "X-Timestamp: <TS>" -H "X-Signature: <SIG>"