查询余额

客户可通过 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 结构片段,不是可独立执行示例。

HTTP
GET https://www.silvamux.com/api/business/v1/customer/balance
Authorization: Bearer $SILVAMUX_API_KEY

响应

200组织当前余额。

application/json · CustomerBalanceResponse

字段类型说明
balance_pointsstring当前余额(points)。

defaultRFC 7807 problem+json 错误(Business API 形态)。

application/problem+json · BusinessError

字段类型说明
detailstring错误详情。
errorsarray<object>字段级错误明细(422 校验失败时返回)。
errors.locationstring出错位置(如 query.request_id)。
errors.messagestring错误信息。
errors.valueany出错字段的值。
instancestring本次错误出现的 URI。
statusintegerHTTP 状态码。
titlestring错误摘要。
typestring错误类型标识(含错误码)。

示例

curl https://www.silvamux.com/api/business/v1/customer/balance \
  -H "Authorization: Bearer $SILVAMUX_API_KEY"

响应:

{
  "balance_points": "42.5"
}
字段说明
balance_points当前余额(points)

错误处理

HTTP 状态错误码说明
401INVALID_TOKENAPI Key 缺失或无效