/wallets/{user_id}/balance
获取指定用户钱包余额
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|---|---|
user_id |
path |
string |
是 | 用户ID |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 200 | OK | service-wallet/internal/handler/dto.BalanceResponse |
| 400 | 请求参数错误 | service-core/base/dto.SimpleResponse |
| 401 | 未认证或令牌无效 | service-core/base/dto.SimpleResponse |
| 500 | 服务内部错误 | service-core/base/dto.SimpleResponse |
引用的 Schema
service-core/base/dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-wallet/internal/handler/dto.BalanceResponse
钱包余额信息
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
available_balance |
string |
否 | 900.00 |
可用 | |
balance |
string |
否 | 1000.00 |
余额 | |
frozen_balance |
string |
否 | 100.00 |
冻结 | |
wallet_id |
string |
否 | wlt_abc123 |
钱包ID |