К содержанию
Lumean API

GET/reseller

Профиль реселлера: статус, личная скидка, лимиты, баланс (available, held, debt). Право: reseller.read.

reseller.read
На этой странице(2)

Возможные ответы

200

Профиль реселлера

Пример тела
{
  "data": {
    "id": "string",
    "status": "string",
    "discount_bps": "string",
    "blocked_reason": "string",
    "approved_at": "string",
    "limits": "string",
    "balance": {
      "key": 1
    },
    "currency_asset": {
      "code": "string",
      "precision": 1
    }
  }
}
Поля ответа
dataобязательное

Полезная нагрузка ответа.

ResellerProfileResellerProfile
idобязательное

ID реселлера.

string
statusобязательное
string
discount_bpsобязательное

Личная скидка реселлера на выпускаемые коды, в базисных пунктах: 100 = 1%. Именно она определяет стоимость кода: cost = nominal × (1 − discount_bps / 10000).

string
blocked_reasonобязательное

Причина блокировки кабинета. null, пока кабинет не заблокирован.

string
approved_atобязательное

Когда заявка на роль реселлера была одобрена.

string
limitsнеобязательное

Лимиты — личные, если администратор их задал, иначе общие умолчания: max_topup_rub — потолок одного пополнения в рублях, max_codes_per_issue — сколько кодов можно выпустить за один запрос POST /reseller/codes.

string
balanceнеобязательное

Баланс кабинета. Каждая сумма приходит парой: в минимальных единицах LMC (available, held, debt, …; real = value / 10^currency_asset.precision) и <имя>_formatted — то же в целых LMC. available — на счёте, held — заморожено, debt — долг перед платформой (его гасит следующее пополнение), spendable — сколько реально можно потратить на выпуск (available за вычетом долга).

object
*необязательное
произвольные ключи
integer | number
currency_assetобязательное

Валюта сумм ответа — LMC. По precision суммы в минимальных единицах переводятся в целые LMC.

object
codeобязательное

Код актива, в котором выражены суммы.

ЗначенияLUMC
string
precisionобязательное

Сколько знаков после запятой у LMC: real = value / 10^precision.

integer
404

not_reseller — у владельца ключа нет профиля реселлера; gift_codes_disabled — фича выключена

Разобрать этот ответ
Пример тела
{
  "success": false,
  "message": "Resource not found."
}
Поля ответа
successобязательное

Всегда false в ответах об ошибке.

boolean
messageобязательное

Текст ошибки на языке ключа (задаётся заголовком X-Locale).

string
reasonнеобязательное

Машиночитаемая причина — приходит у бизнес-отказов (например, invalid_order_status); у прочих ошибок поля нет. Ветвите обработку по нему, а не по тексту сообщения.

string
error_codeнеобязательное

Тот же машинный код, что в reason, — второе имя поля. Приходит вместе с reason, значения всегда совпадают.

string

Рядом

Объекты

Соседние операции

Скормить страницу ИИ

Открыть .mdllm.md

спека 0.0.1