读取账户余额

读取您的 API 凭据所对应账户的余额、币种和付款条件值。这是余额查询操作，不会充值或下单。

请求

通过 HTTPS 使用服务端 API 凭据。示例从环境变量中读取凭据，不包含任何可用的凭据。请检查 status.code（位于 JSON 正文中），同时检查 HTTP 状态。这些旧版处理程序在发生应用错误时，并不总是设置 HTTP 错误状态。

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/getbalance"

无需提供路径参数、查询参数或请求体参数。

此处仅展示响应结构示例，并非账户数据或当前报价。

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "balance": "125.50",
    "currency": "USD",
    "terms": "prepaid"
  }
}

余额响应字段
字段	含义
`balance`	存储的账户余额。使用金额值时，请保留小数精度。
`currency`	为此账户存储的币种值。
`terms`	账户中存储的付款条件值。处理程序不会枚举或规范化该值；请勿认为示例涵盖了所有可能的值。

身份验证失败时使用通用的 API 身份验证响应。此处理程序未定义单独的余额缺失错误，也未定义分页机制。返回余额并不意味着预留了资金，也不保证后续订单能够成功。