本节导读

钱包图标

接口说明

本接口用于查询账户当前余额、已发送量和计费类型(预付费/后付费)。

信息图标 接口地址

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格式请求:

http://cloud.thinksms.cn/sms.aspx?action=overage&rt=json&userid=企业ID&account=账号&password=密码

XML格式请求:

http://cloud.thinksms.cn/sms.aspx?action=overage&userid=企业ID&account=账号&password=密码
回复图标

响应数据

JSON格式响应:

{ "ReturnStatus": "Success", "Message": "", "Payinfo": "后付费", "Overage": 109346, "SendTotal": 1075 }

XML格式响应:

Success 后付费 109346 1075

字段说明

ReturnStatus/returnstatus 返回状态值:成功返回Success,失败返回:Faild
Message/message 返回信息提示
Payinfo/payinfo 返回支付方式:后付费,预付费
Overage/overage 返回余额
SendTotal/sendtotal 返回总点数,当支付方式为预付费时返回总充值点数

常见返回信息

返回信息提示 说明
返回空 查询成功,将返回相应的支付方式、账户使用条数、总充值点数
用户名或密码不能为空 提交的用户名或密码为空
用户名或密码错误 表示用户名或密码错误
账户不存在 指定的账户不存在或已被禁用

支付方式说明

  • 信用卡图标

    预付费

    需要先充值后使用,Overage字段显示剩余条数,SendTotal字段显示总充值条数

  • 发票图标

    后付费

    先使用后付款,按月结算,Overage字段可能显示信用额度或为0,SendTotal字段无意义

  • 警告图标

    注意事项

    客服图标 需要帮助?

    我们的服务团队随时为您提供支持,解决您在使用过程中遇到的任何问题

    时间图标 服务时间:周一至周日 8:00-22:00(全年在线)