查询静态账户余额
查看充值、赠送、冻结及可购买余额。
只只HTTP技术团队维护更新于 2026年10月6日
接口与认证
GET
/openapi/v1/static/balance查询账户余额。仅访问当前令牌账户的数据。
使用 HTTPS 和账户 API 令牌。响应包含 Cache-Control: no-store 和 X-Request-Id。
示例为合成数据与占位凭据,仅说明结构。接口合同不代表目标环境已开放,开放状态以控制台为准。
下载 OpenAPI · 导入 Apifox / Postman请求参数
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
api_key | string | 是 | Query · 唯一非空 | 账户 API 令牌,在受控服务端保存;示例使用占位符。 |
无请求体。
请求示例
curl --request GET \
"https://api.zzhttp.com/openapi/v1/static/balance?api_key=${STATIC_API_KEY}"成功响应
成功
响应不包含代理密码,凭据仅由专用接口返回。
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
code | integer | 是 | 固定 200 | 统一数字业务码:HTTP 与业务码成功均为 200;异步受理不代表交付完成。 |
message | string | 是 | — | 服务端结果说明。 |
requestId | string | 是 | — | 本次请求的追踪 ID,用于排障,不是业务幂等编号。 |
data | object | 是 | — | 本接口业务数据。 |
data.rechargeBalanceCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
data.giftBalanceCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
data.frozenAmountCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
data.purchasableAmountCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
data.currency | string | 是 | 固定 CNY | 金额币种,当前合同为 CNY。 |
{
"code": 200,
"message": "成功",
"requestId": "00000000-0000-4000-8000-000000000001",
"data": {
"rechargeBalanceCents": 10000,
"giftBalanceCents": 2000,
"frozenAmountCents": 0,
"purchasableAmountCents": 12000,
"currency": "CNY"
}
}错误与重试
读取请求遇到业务码 10713 按 Retry-After 等待;500 可有限重试。分组创建结果不明时先查询分组列表;移动同一目标可安全重试。
错误码、HTTP 状态、错误响应字段及恢复方式统一见错误码与处理建议。
这篇内容解决了你的问题吗?
反馈只用于改进公开文档,不会提交账号或请求信息。