GET/v1/billing/balance

查询账户余额

适合在管理后台或外部系统中拉取余额与信用额度概览。

基础信息

鉴权	Authorization: Bearer 管理 token
请求类型	none
响应类型	application/json

请求参数

该接口没有额外请求参数。

响应示例

json

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "balance": 1280.5,
    "totalRecharge": 5000,
    "totalConsume": 3719.5,
    "billingStrategy": "PREPAID",
    "creditLimit": 0
  }
}

错误码

HTTP	code	说明
401	`unauthorized`	管理开放 API 鉴权失败。
400	`validation_error`	请求参数格式错误或取值不满足约束。
404	`not_found`	目标资源不存在或不属于当前商户。

在线调试

Playground · 浏览器直连网关

查询账户余额

返回当前商户余额、累计充值、累计消费和财务策略。

Base URL Token / API Key

json

尚未发起请求。

bash

curl --location --request GET 'https://api.harnmodel.com/v1/billing/balance' \
  --header 'Authorization: Bearer mgmt-token-xxx'

多语言示例

bash

curl --location --request GET 'https://api.harnmodel.com/v1/billing/balance' \
  --header 'Authorization: Bearer mgmt-token-xxx'