用于查询账户当前余额、已发送量和计费类型
本接口用于查询账户当前余额、已发送量和计费类型(预付费/后付费)。
UTF-8 http://cloud.thinksms.cn/sms.aspx
GBK http://cloud.thinksms.cn/smsGBK.aspx
Content-Type: application/x-www-form-urlencoded
提示:建议在发送短信前先查询余额,避免因余额不足导致发送失败
参数名称 | 含义 | 类型 | 必填 | 说明 |
---|---|---|---|---|
action | 请求动作 | string | 是 | 固定为:overage |
userid | 企业ID | string | 是 | 企业ID(登陆后台-客户管理-我的信息) |
account | 帐号 | string | 是 | 短信帐号 |
password | 密码 | string | 是 | 登陆密码 |
rt | 返回格式 | string | 否 | 固定值:json,不填则为XML格式返回 |
JSON格式请求:
XML格式请求:
JSON格式响应:
XML格式响应:
返回信息提示 | 说明 |
---|---|
返回空 | 查询成功,将返回相应的支付方式、账户使用条数、总充值点数 |
用户名或密码不能为空 | 提交的用户名或密码为空 |
用户名或密码错误 | 表示用户名或密码错误 |
账户不存在 | 指定的账户不存在或已被禁用 |
需要先充值后使用,Overage字段显示剩余条数,SendTotal字段显示总充值条数
先使用后付款,按月结算,Overage字段可能显示信用额度或为0,SendTotal字段无意义
Payinfo字段表示支付方式:后付费=先使用后付款,预付费=先充值后使用。
Overage字段返回账户当前余额,单位为短信条数。
SendTotal字段当支付方式为预付费时返回总充值点数,后付费账户此字段可能为0或无意义。
根据您的系统编码选择对应的接口地址,UTF-8编码使用sms.aspx,GBK编码使用smsGBK.aspx。
不建议在前端代码中直接使用密码参数,建议通过服务器端进行中转调用。
建议合理控制查询频率,避免过于频繁的查询请求。