这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 | |||
短信:send_record [2017/11/09 02:35] admin [查询短信发送记录] |
— (当前版本) | ||
---|---|---|---|
行 1: | 行 1: | ||
- | ======查询短信发送记录====== | ||
- | **请求地址** | ||
- | <code> | ||
- | https://open.ucpaas.com/ol/sms/send_record | ||
- | </code> | ||
- | |||
- | **请求方式**\\ | ||
- | 请求方式:POST,支持HTTPS | ||
- | |||
- | <html><p style="font-size;28px; color:red ;"> | ||
- | <b>注意:请求频率不得高于2秒/次</b><br> | ||
- | </html> | ||
- | |||
- | **JSON 请求示例**\\ | ||
- | ^参数 ^类型 ^约束 ^描述 ^示例 ^ | ||
- | |token|String|必填|用户密钥“Auth Token”,在开发者控制台获取([[短信:authentication_sms#Token 和 sid|位置]])|23f757bad208226ec301e117e40006ed| | ||
- | |sid|String|必填|用户的账号唯一标识“Account Sid”,在开发者控制台获取([[短信:authentication_sms#Token 和 sid|位置]])|39467b989d087c2d92c6132184a365d8| | ||
- | |appid|String|选填|创建应用时系统分配的唯一标示([[短信:authentication_sms#appid|位置]]),如为空则查询该账号下所有应用的记录|2d92c6132139467b989d087c84a365d8| | ||
- | |mobile|String|选填|查询的手机号码,如不填则输出查询时间内的所有发送记录|18011984299| | ||
- | |start_date|String|必填|短信发送开始时间,格式YYYY-MM-DD hh:mm:ss|2017-08-28 18:08:28| | ||
- | |end_date|String|必填|短信发送结束时间,格式YYYY-MM-DD hh:mm:ss,不得早于开始时间,暂只可查询一天内的记录|2017-08-28 19:08:28| | ||
- | |page_num|String|必填|页码,默认值为1,最大不超过查询结果的总页数|1| | ||
- | |page_size|String|选填|每页个数,最大100个,默认50个|50| | ||
- | |type|String|选填|选择短信类型,默认为0,获取验证通知及会员营销短信记录;1,只获取验证通知类短信;2,只能获取会员营销短信记录。|0| | ||
- | |uid|String|选填|查询特定uid的发送记录(uid为请求发送短信时提交的值)|2d92c6132139467b989d087c84a365d8| | ||
- | |||
- | <code json> | ||
- | { | ||
- | "sid":"39467b989d087c2d92c6132184a365d8", | ||
- | "token":"23f757bad208226ec301e117e40006ed", | ||
- | "appid":"2d92c6132139467b989d087c84a365d8", | ||
- | "mobile":"18011984299", | ||
- | "start_date":"2017-08-28 18:08:28", | ||
- | "end_date":"2017-08-28 19:08:28" | ||
- | } | ||
- | </code> | ||
- | |||
- | **JSON 响应示例**\\ | ||
- | ^参数 ^类型 ^描述 ^示例 ^ | ||
- | |record_sum|String|记录条数|1000| | ||
- | |page_pos|String|当前所在页码|10| | ||
- | |appid|String|应用的appid|9284cd580d8f953f96f79240e372587e| | ||
- | |smsid|String|短信id|f96f79240e372587e9284cd580d8f953| | ||
- | |mobile|String|接收的手机号码|18011984299| | ||
- | |send_date|String|发送时间,格式YYYY-MM-DD hh:mm:ss|2017-08-28 19:08:28| | ||
- | |content|String|短信内容|【云之讯】您的注册验证码是870828| | ||
- | |send_status|String|发送状态,状态有:SUCCESS/FAIL|SUCCESS| | ||
- | |report_status|String|发送报告状态,状态有:SUCCESS/FAIL|SUCCESS| | ||
- | |report_msg|String|对应状态码的信息|例如:"明确成功"| | ||
- | |count|String|计费条数|1| | ||
- | |fee|String|费用(元)|0.05,如为套餐包抵扣则显示为“0.0”| | ||
- | |uid|String|请求时透传的uid|2d92c6132139467b989d087c84a365d8| | ||
- | |||
- | |||
- | <code json> | ||
- | { | ||
- | "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":"" | ||
- | }] | ||
- | } | ||
- | </code> | ||
- | |||
- | =====相关资料===== | ||
- | [[:sms_sdk|SDK下载]] [[:error_code|返回码]] |