查询当前 API Token 所属账户的剩余开放能力积分。积分按租户共享，仅可查询自己的账户，不能指定其他用户或租户。
GET/api/third-party/common/balance
请求头
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-API-Token | string | 是 | 平台提供的调用凭证，用于识别当前账号或租户。 |
请求参数
无需 Query 参数或请求体。账户由 X-API-Token 自动识别，传入 userId、username、tenantId 等参数将返回 400；tenant-id 请求头不能切换查询账户。
请求示例
bash
curl -X GET "https://yunfanzhilian.com/api/third-party/common/balance" \
-H "X-API-Token: your_token"响应字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| data.remainCoins | number | - | 当前账户剩余开放能力积分，与后台可用积分及生成接口扣费使用的积分一致，最多保留三位小数。 |
响应示例
json
{
"code": 200,
"message": "获取积分余额成功",
"data": {
"remainCoins": 96
},
"timestamp": "2026-09-22T08:00:00.000Z"
}未提供、无效或已过期的 Token 返回 401；无访问权限或所属账户不可用时返回 403。查询不会扣除金额或积分。