Получить баланс группы

POST /user/balance

Описание

Метод возвращает текущий баланс учётной записи (группы, к которой относится пользователь). Для доступа нужен токен, см. раздел «Авторизация».

Формат запроса

  • HTTP метод: POST
  • URL: /user/balance
  • Тип контента: application/json

Авторизация

Токен передаётся одним из способов:

  • заголовок token: <jwt-token> — временный JWT-токен, полученный методом user/login;
  • поле token в теле запроса — постоянный API-токен (UUID) из личного кабинета.

Без токена запрос вернёт 401 access denied.

Пример запроса (cURL)

curl -X POST "https://api.neuro-vision.ru/v1/user/balance" -H "Content-Type: application/json" -H "token: <jwt-token>"

Примеры ответов

Успех (200 OK)

{
  "status": "ok",
  "message": "balance",
  "balance": 1250.5
}
ПолеТипОписание
balancenumberТекущий баланс учётной записи; 0, если средств нет

Ошибка (400 Bad Request)

{
  "message": "invalid schema",
  "status": "error"
}

Ошибка (400 Bad Request) — пользователь не состоит в группе

{
  "message": "Access denied",
  "status": "error"
}

Ошибка (401 Unauthorized)

{
  "message": "access denied",
  "status": "error"
}