Обновить баланс группы

POST /user/balance/update


Описание

Метод позволяет обновить баланс указанной группы, изменяя его на заданную сумму. Используется для ручного пополнения или списания баланса группы.


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

  • HTTP метод: POST
  • URL: /user/balance/update
  • Тип контента: application/json
  • Авторизация: требуется

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

ПараметрТипГде передаётсяОбязательныйОписание
tokenstringHeaderJWT-токен пользователя

Тело запроса (JSON)

ПолеТипОбязательныйОписание
groupIdintegerИдентификатор группы
amountnumberСумма для изменения баланса (может быть отрицательной)

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

curl -X POST "https://api.neuro-vision.ru/v1/user/balance/update" 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer jwt.temporary.token" 
  -d '{
    "groupId": 1,
    "amount": 1000
  }'

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

Успех (200 OK)
{
  "status": "ok"
}
Ошибка (400 Bad Request)
{
  "message": "invalid schema",
  "status": "error"
}
Ошибка (401 Unauthorized)
{
  "message": "access denied",
  "status": "error"
}
Ошибка (404 Not Found)
{
  "message": "item with this id does not found",
  "status": "error"
}