查询个人账户余额

接口路径

GET /api/open/user/self

余额计算说明

最终余额（人民币）计算方式：

最终余额(¥) = quota ÷ quota_per_unit × usd_exchange_rate

其中：

• quota：来自本接口返回的 data.quota
• quota_per_unit、usd_exchange_rate、quota_display_type：来自 查询系统状态 接口（GET /api/open/status）

若 quota_display_type = USD（美元），则去掉 × usd_exchange_rate。

请求参数

无请求参数。

请求示例

GET 'https://neolink.com/backend/api/open/user/self'

返回信息

字段	类型	是否必传	说明	备注
success	bool	是	请求是否成功	固定值
message	string	是	错误提示信息（成功时为空）	固定值
data	UserSelf	是	当前用户详细信息	详见下表

UserSelf 对象

字段	类型	是否必传	说明	备注
id	int	是	用户 ID	用户唯一标识
username	string	是	用户名	登录用户名
display_name	string	是	显示名称	用户昵称/真名
status	int	是	账户状态	见下文状态枚举表
quota	int	是	充值配额余额	仅计算充值部分，不含代金券
used_quota	int	是	已消耗配额	累计消耗的配额
voucher_quota	int	是	代金券余额	通过兑换码等方式获得的配额
request_count	int	是	API 调用次数	累计调用次数

账户状态枚举（status 字段）

枚举值	名称	说明	可用状态
0	未激活	账户已创建但未激活	❌ 不可用
1	正常	账户正常	✅ 可用
2	已禁用	账户已被禁用	❌ 不可用

返回示例

成功响应（普通用户）
{
  "success": true,
  "message": "",
  "data": {
    "id": 12,
    "username": "alice",
    "display_name": "张三",
    "status": 1,
    "quota": 5000000,
    "used_quota": 1000000,
    "voucher_quota": 500000,
    "request_count": 250
  }
}
错误响应
{
  "success": false,
  "message": "未授权，请先登录"
}