获取用户可用余额接口

暂无描述

接口状态

已完成

接口URL

http://127.0.0.1:9990/sms/getBalance

请求方式

GET

Content-Type

json

请求Header参数

参数名	示例值	参数类型	是否必填	参数描述
Authorization	eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6IjM4ZTFiYWE3LTAyNjUtNDY4ZC04MDM4LTVmOGM1ZmRhMTE3MCJ9.d-emwZIt7pPXGPz03fiYJdHgwRX8q8SLW2UODbmF7Iq8isXVo1-4OQ2GEGgx_pASi75NAzclFwa8fB-g-WqyXg	String	是	TOKEN头

请求Body参数

认证方式

noauth

成功响应示例

{
    "msg": "成功",
    "code": 200,
    "data": {
        "status": 0,
        "timestamp": 1660123775136,
        "userBalance": 0.56,
        "chargeType": 1,
        "availableSentCount": "1"
    }
}

参数名	示例值	参数类型	参数描述
code	200	Number	状态码
msg	成功	String	状态描述
data	-	Object	返回数据
data.status	-	Integer	用户状态 0=正常,1=停用
data.timestamp	1651908910541	Number	查询时间戳
data.userBalance	420.1	BigDecimal	用户可用余额余额获取有缓存,不作为判断依据
data.chargeType	1	Integer	用户付费方式 0=预付费 1=后付费
data.availableSentCount	0	Integer	剩余可发送条数。(注意:国际版没有可发送条数字段)

错误响应示例

{
    "msg": "请求访问：/sms/getBalance 失败，访问受限,未授权！",
    "code": 401
}

参数名	示例值	参数类型	参数描述
msg	请求访问：/sms/getBalance 失败，访问受限,未授权！	String	未传TOKEN
code	401	Integer	状态码

作者：smswg 创建时间：2023-06-09 15:12
最后编辑：smswg 更新时间：2025-06-27 15:13