POST /user/balance/update
Описание
Метод позволяет обновить баланс указанной группы, изменяя его на заданную сумму. Используется для ручного пополнения или списания баланса группы.
Формат запроса
- HTTP метод:
POST - URL:
/user/balance/update - Тип контента:
application/json - Авторизация: требуется
Параметры запроса
| Параметр | Тип | Где передаётся | Обязательный | Описание |
|---|---|---|---|---|
| token | string | Header | ✅ | JWT-токен пользователя |
Тело запроса (JSON)
| Поле | Тип | Обязательный | Описание |
|---|---|---|---|
| groupId | integer | ✅ | Идентификатор группы |
| amount | number | ✅ | Сумма для изменения баланса (может быть отрицательной) |
Пример запроса (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"
}