SY-P02-1.0.001
API: message/balancelog - 短信余额日志查询
概览
message/balancelog 是 SUBMAIL 的短信余额变更记录查询 API。
使用 message/balancelog 可以实时获取您账户的短信余额变更记录。
URL
https://api-v4.mysubmail.com/message/balancelog
支持格式
| 格式 | URL |
|---|
json | https://api-v4.mysubmail.com/balance/message/balancelog.json（默认） |
http 请求方式
| 请求方式 | content-type设置 |
|---|
| http post | multipart/form-data、x-www-form-urlencoded、application/json |
是否需要授权
是
balance/mail POST 方法 请求参数
| 参数 | 类型 | 必需/可选 | 默认 | 描述 |
|---|
appid | string | 必需 | 无 | 在 SUBMAIL 应用集成中创建的短信应用ID |
signature | string | 必需 | 无 | 应用密匙 _或 _数字签名参阅 API 授权与验证机制 > 授权和验证方式 |
timestamp | UNIX 时间戳 | 可选 | 无 | 参阅 API 授权与验证机制 > Timestamp UNIX 时间戳 |
sign_type | string | 可选 | normal | API 授权模式（ md5 or sha1 or normal ）参阅 API 授权与验证机制 > 授权和验证方式 |
start_date | UNIX 时间戳 | 可选 | 1天前 | 开始时间，unix时间戳，精确到秒 eg:1640100000 |
end_date | UNIX 时间戳 | 可选 | 当前时间 | 结束时间，unix时间戳，精确到秒 eg:1640100000 |
代码示例
发送 CURL
curl -d "appid=your_appid&signature=your_appkey" http://api-v4.mysubmail.com/message/balancelog
返回
{
"data": [
{
"datetime": "2024-06-14 16:54:01", //变更时间
"message": "CS14123895387", //订单编号
"tmessage_add_credits": "10000", //事务类短信增加余额
"tmessage_after_credits": "107361", //事务类短信增加后账户余额
"tmessage_before_credits": "97361" //事务类短信增加前账户余额
},
{
"datetime": "2024-06-19 16:31:12",
"message": "向子账户增加余额",
"tmessage_add_credits": "-100",
"tmessage_after_credits": "107228",
"tmessage_before_credits": "107328"
},
{
"datetime": "2024-06-19 16:31:18",
"message": "向子账户增加余额",
"message_add_credits": "-100", //运营类短信增加余额
"message_after_credits": "96918", //运营类短信增加后账户余额
"message_before_credits": "97018" //运营类短信增加后账户余额
}
],
"status": "success"
}
返回值
请求失败
{
"status":"error",
"code":"1xx",
"msg":"error message"
}
错误代码
