餘額查詢

用於查詢當前 API Key 所屬應用的可用餘額。查詢應用由 API Key 決定，無需在請求中傳入應用 ID。

GET https://otp.api.engagelab.cc/v1/balance

請參考調用驗證了解如何進行 API 鑑權。

GET /v1/balance HTTP/1.1 Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0

              
              GET /v1/balance HTTP/1.1
Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0

此代碼塊在浮窗中顯示

無請求參數。

{ "currency": "USD", "balance": "123.4500", "gift_balance": "1.0000", "total_balance": "124.4500" }

              
              {
    "currency": "USD",
    "balance": "123.4500",
    "gift_balance": "1.0000",
    "total_balance": "124.4500"
}

此代碼塊在浮窗中顯示

金額均為字符串小數，保留 4 位小數。這樣設計是為了避免浮點數在傳輸與解析過程中產生精度誤差，請使用高精度小數類型（如各語言的 BigDecimal / Decimal）解析，不要直接當浮點數運算。
幣種：當前所有應用均以美元（USD）結算。
餘額可能為負：開通了透支額度的應用，在透支後 balance / total_balance 可能返回負值（如 "-12.3400"），表示已欠費，請及時充值。
total_balance 由服務端在同一時刻一致計算得出，可直接用於展示與對賬。

http 狀態碼為 4xx 或者 5xx，響應體包含字段如下：

字段	類型	選項	描述
code	int	必填	錯誤碼，詳見錯誤碼說明
message	String	必填	錯誤詳情

{ "code": 2001, "message": "invalid token" }

              
              {
    "code": 2001,
    "message": "invalid token"
}

此代碼塊在浮窗中顯示