Метрики
GET /metrics — привязанные пользователи, выручка месяца, незакрытые выплаты.
Запрос
GET /api/v1/reseller/metrics
Authorization: Bearer rsk_<ключ>
200 OK
{
"users_attributed": 432,
"revenue_current_month": [
{ "currency": "RUB", "amount_cents": 12874500 },
{ "currency": "USD", "amount_cents": 4200 }
],
"pending_payouts": [
{ "currency": "RUB", "amount_cents": 3862350 }
]
}
users_attributed— сколько аккаунтов привязано к вам всего.revenue_current_month— успешные платежи ваших клиентов с начала текущего календарного месяца, по одной записи на валюту, в минорных единицах (копейки для RUB, центы для USD).pending_payouts— то же по строкам выплат в статусеpending.
Пустой список — это ответ, а не ошибка: денег в этой валюте пока не было.
Почему это список, а не число
Потому что суммировать рубли с долларами нельзя, а раньше мы именно это и делали — складывали всё в одно поле и подписывали его USD. Для партнёра с рублёвым прайсом число получалось завышенным примерно в девяносто раз. Складывайте только внутри валюты; между валютами — не складывайте вообще.
Требуется скоуп metrics:read.
Ограничения
- Разбивки по планам и оттока здесь нет. Тренды и разрез по клиентам — в кабинете, на дашборде; график рисуется по одной валюте (по умолчанию той, в которой у вас больше выручки, параметр
?currency=переключает). - Значения считаются на лету по базе, кэша на нашей стороне нет. Опрашивайте не чаще раза в несколько минут.