查询积分余额 API
查询当前 API Key 所属用户的可用积分余额。
接口地址
GET https://api.goanyapi.com/api/v1/credits/balance该接口免费，不扣除积分，也不会创建积分消费记录。
鉴权方式
Authorization: Bearer YOUR_API_KEY请求参数
无需请求参数。
请求示例
curl "https://your-domain.com/api/v1/credits/balance" \
-H "Authorization: Bearer YOUR_API_KEY"响应示例
{
"code": "ok",
"message": "ok",
"data": {
"remainingCredits": 12500
}
}响应字段
| 字段 | 说明 |
|---|---|
data.remainingCredits | 当前可用积分余额 |
余额只统计状态有效且未过期的积分。
错误码
| HTTP 状态 | code | 说明 |
|---|---|---|
| 401 | missing_api_key | 缺少 Authorization 请求头 |
| 401 | invalid_api_key | API Key 无效 |
| 401 | invalid_api_key_owner | API Key 所属用户不存在 |
| 429 | rate_limit_exceeded | 请求过于频繁 |
| 500 | internal_error | 服务内部错误 |
在线测试
可以在 Open API Tester 中选择 Credit Balance API。测试器会发送真实请求，但不会扣除积分。