用户工具

短信:send_record

这是本文档旧的修订版!


查询短信发送记录

请求地址

https://api.ucpaas.com/ol/sms/send_record						

请求方式
请求方式:POST,支持HTTPS

注意:请求频率不得高于2秒/次

JSON 请求示例

参数 类型 约束 描述 示例
tokenString必填用户密钥“Auth Token”,在开发者控制台获取(位置23f757bad208226ec301e117e40006ed
sidString必填用户的账号唯一标识“Account Sid”,在开发者控制台获取(位置39467b989d087c2d92c6132184a365d8
appidString选填创建应用时系统分配的唯一标示(位置),如为空则查询该账号下所有应用的记录2d92c6132139467b989d087c84a365d8
mobileString选填查询的手机号码,如不填则输出查询时间内的所有发送记录18011984299
start_dateString必填短信发送开始时间,格式YYYY-MM-DD hh:mm:ss2017-08-28 18:08:28
end_dateString必填短信发送结束时间,格式YYYY-MM-DD hh:mm:ss,不得早于开始时间,暂只可查询一天内的记录2017-08-28 19:08:28
page_numString必填页码,默认值为1,最大不超过查询结果的总页数1
page_sizeString选填每页个数,最大100个,默认50个50
typeString选填选择短信类型,默认为0,获取验证通知及会员营销短信记录;1,只获取验证通知类短信;2,只能获取会员营销短信记录。0
uidString选填查询特定uid的发送记录(uid为请求发送短信时提交的值)2d92c6132139467b989d087c84a365d8
{
 "sid":"39467b989d087c2d92c6132184a365d8",
 "token":"23f757bad208226ec301e117e40006ed",
 "appid":"2d92c6132139467b989d087c84a365d8",
 "mobile":"18011984299",
 "start_date":"2017-08-28 18:08:28",
 "end_date":"2017-08-28 19:08:28"
}

JSON 响应示例

参数 类型 描述 示例
record_sumString记录条数1000
page_posString当前所在页码10
appidString应用的appid9284cd580d8f953f96f79240e372587e
smsidString短信idf96f79240e372587e9284cd580d8f953
mobileString接收的手机号码18011984299
send_dateString发送时间,格式YYYY-MM-DD hh:mm:ss2017-08-28 19:08:28
contentString短信内容【云之讯】您的注册验证码是870828
send_statusString发送状态,状态有:SUCCESS/FAILSUCCESS
report_statusString发送报告状态,状态有:SUCCESS/FAILSUCCESS
report_msgString对应状态码的信息例如:“明确成功”
countString计费条数1
feeString费用(元)0.05,如为套餐包抵扣则显示为“0.0”
uidString请求时透传的uid2d92c6132139467b989d087c84a365d8
{
 "code":"0",
 "msg":"查询成功",
 "record_sum":"2",
 "page_pos":"1",
 "report":[{
 "appid":"9284cd580d8f953f96f79240e372587e",
 "smsid":"f96f79240e372587e9284cd580d8f953",
 "mobile":"18011984299",
 "send_date":"2017-08-28 19:08:28",
 "content":"【云之讯】您的注册验证码是870828",
 "send_status":"SUCCESS",
 "report_status":"SUCCESS",
 "report_msg":"明确成功",
 "count":"1",
 "fee":"0.05",
 "uid":""
},{
 "appid":"9284cd580d8f953f96f79240e372587e",
 "smsid":"f84f79240e372587e9284cd580d8f953",
 "mobile":"18011984199",
 "send_date":"2017-08-28 19:08:28",
 "content":"【云之讯】您的注册验证码是870828",
 "send_status":"SUCCESS",
 "report_status":"FAIL",
 "report_msg":"超频",
 "count":"0",
 "fee":"0.0",
 "uid":""
}]
}					

相关资料


页面工具