查询余额
客户可通过 API Key(sk_live_ 开头)程序化查询组织余额,无需登录态。接口仅接受 API Key 鉴权,余额为组织级。
在请求头携带 API Key:
Authorization: Bearer sk_live_YOUR_API_KEY
API Key 在控制台「API Keys」页面创建,绑定到某个组织与项目。
GET/api/business/v1/customer/balance
查询余额
返回 API Key 所属组织的当前余额(points)。仅接受 API Key(sk_live_)鉴权,无需登录态。
🔑Bearer API Key请求头使用 Authorization: Bearer sk_live_...,也支持 x-api-key。
请求结构
下方内容用于确认方法、地址和鉴权方式,属于 HTTP 结构片段,不是可独立执行示例。
GET https://www.silvamux.com/api/business/v1/customer/balance
Authorization: Bearer $SILVAMUX_API_KEY
响应
200组织当前余额。
application/json · CustomerBalanceResponse
| 字段 | 类型 | 说明 |
|---|
balance_points | string | 当前余额(points)。 |
defaultRFC 7807 problem+json 错误(Business API 形态)。
application/problem+json · BusinessError
| 字段 | 类型 | 说明 |
|---|
detail | string | 错误详情。 |
errors | array<object> | 字段级错误明细(422 校验失败时返回)。 |
errors.location | string | 出错位置(如 query.request_id)。 |
errors.message | string | 错误信息。 |
errors.value | any | 出错字段的值。 |
instance | string | 本次错误出现的 URI。 |
status | integer | HTTP 状态码。 |
title | string | 错误摘要。 |
type | string | 错误类型标识(含错误码)。 |
curl https://www.silvamux.com/api/business/v1/customer/balance \
-H "Authorization: Bearer $SILVAMUX_API_KEY"
# pip install requests
import os
import requests
resp = requests.get(
"https://www.silvamux.com/api/business/v1/customer/balance",
headers={"Authorization": f"Bearer {os.environ['SILVAMUX_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json()) # {"balance_points": "42.5"}
// Node 18+(内置 fetch)
const resp = await fetch(
"https://www.silvamux.com/api/business/v1/customer/balance",
{
headers: { Authorization: `Bearer ${process.env.SILVAMUX_API_KEY}` },
},
);
const data = await resp.json();
console.log(data); // { balance_points: "42.5" }
// 仅依赖标准库
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("GET", "https://www.silvamux.com/api/business/v1/customer/balance", nil)
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("SILVAMUX_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
响应:
{
"balance_points": "42.5"
}
| 字段 | 说明 |
|---|
balance_points | 当前余额(points) |
| HTTP 状态 | 错误码 | 说明 |
|---|
| 401 | INVALID_TOKEN | API Key 缺失或无效 |