API: Balance/InternationalSMS - 国际短信余额查询
概览
balance/internationalsms 是 SUBMAIL 的国际短信余额查询 API。
使用 balance/internationalsms 可以实时获取您账户的国际短信余额。
URL
https://api-v4.mysubmail.com/balance/internationalsms
支持格式
| 格式 | URL |
|---|---|
json | https://api-v4.mysubmail.com/balance/internationalsms.json （默认） |
xml | https://api-v4.mysubmail.com/balance/internationalsms.xml |
yaml | https://api-v4.mysubmail.com/balance/internationalsms.yaml |
http 请求方式
| 请求方式 | content-type设置 |
|---|---|
http post | multipart/form-data、x-www-form-urlencoded、application/json |
是否需要授权
是
参阅 API 授权和验证机制
balance/sms POST 方法 请求参数
| 参数 | 类型 | 必需/可选 | 默认 | 描述 |
|---|---|---|---|---|
appid | string | 必需 | 无 | 在 SUBMAIL 应用集成中创建的国际短信应用 ID |
timestamp | UNIX 时间戳 | 可选 | 无 | 参阅 API 授权与验证机制 > Timestamp UNIX 时间戳 |
sign_type | string | 可选 | normal | API 授权模式（ md5 or sha1 or normal ）参阅 API 授权与验证机制 > 授权和验证方式 |
signature | string | 必需 | 无 | 应用密匙或数字签名 参阅 API授权与验证机制 > 授权和验证方式 |
代码示例
发送 CURL
curl -d "appid=your_appid&signature=your_appkey" http://api.mysubmail.com/balance/internationalsms.json
返回
{
"status": "success",
"balance": 100.15,
"balance_type":"USD" USD/RMB 对应账户当前使用的币种
}返回值
请求成功
{
"status":"success"
}请求失败
{
"status":"error",
"code":"1xx",
"msg":"error message"
}