🔄 Получение балансов магазина
Code samples
GET /v2/shops/{shopId}/balances
🛠️ Параметры
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| shopId | path | integer | true | ID магазина |
Example responses
200 Response
{
"success": true,
"data": {
"balances": [
{
"shop_id": 5,
"currency": "rub",
"balance": 1000.5,
"hold": 200,
"available": 800.5
}
]
}
}
401 Response
{
"error": "unauthorized",
"status": 401
}
403 Response
{
"success": false,
"message": "Магазин не найден или не принадлежит текущему пользователю"
}
422 Response
{
"success": false,
"message": "Ошибка валидации",
"errors": {
"shop_id": [
"Поле shop_id должно быть целым числом."
]
}
}
🔁 Ответы
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Список балансов магазина | Inline |
| 401 | Unauthorized | Unauthorized | None |
| 403 | Forbidden | Forbidden | None |
| 422 | Unprocessable Entity | Ошибка валидации данных | None |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| » success | boolean | false | none | Флаг успеха |
| » data | object | false | none | none |
| »» balances | [Balance] | false | none | [Баланс магазина] |
| »»» shop_id | integer | false | none | ID магазина |
| »»» currency | string | false | none | Валюта баланса |
| »»» balance | number(float) | false | none | Общий баланс |
| »»» hold | number(float) | false | none | Сумма на холде |
| »»» available | number(float) | false | none | Доступная сумма (balance - hold) |