注册送短信

SY-P04-1.0.001

API: mms/balancelog - 账户余额日志查询


概览


mms/balancelog 是 SUBMAIL 的账户余额变更记录查询 API。

使用 mms/balancelog 可以实时获取您账户的余额变更记录。



URL


https://api-v4.mysubmail.com/mms/balancelog


支持格式


格式URL
jsonhttps://api-v4.mysubmail.com/balance/mms/balancelog.json(默认)


http 请求方式


请求方式content-type设置
http postmultipart/form-data、x-www-form-urlencoded、application/json


是否需要授权


参阅 API 授权和验证机制


balance/mail POST 方法 请求参数


参数类型必需/可选默认描述
appidstring必需在 SUBMAIL 应用集成中创建的彩信应用ID
timestampUNIX 时间戳可选参阅 API 授权与验证机制 > Timestamp UNIX 时间戳
sign_typestring可选normalAPI 授权模式( md5 or sha1 or normal )参阅 API 授权与验证机制 > 授权和验证方式
signaturestring必需应用密匙 _或 _数字签名参阅 API 授权与验证机制 > 授权和验证方式
start_dateUNIX 时间戳可选1天前开始时间,unix时间戳,精确到秒 eg:1640100000
end_dateUNIX 时间戳可选当前时间结束时间,unix时间戳,精确到秒 eg:1640100000


代码示例


发送 CURL
curl -d "appid=your_appid&signature=your_appkey" http://api-v4.mysubmail.com/internationalsms/balancelog


返回
{
    "data": [
        {
            "datetime": "2024-06-14 16:54:01",               //变更时间
            "message": "CS14123895387",                       //订单编号
            "money_add_credits": "10000",                    //增加的账户余额
            "money_after_credits": "107361",                //增加后账户余额
            "money_before_credits": "97361"                 //增加前账户余额
        }
    ],
    "status": "success"
}


返回值


请求失败
{
"status":"error",
"code":"1xx",
"msg":"error message"
}


错误代码


参阅 API 错误代码