首页 帮助中心 API

查询时间段内发送的短信结果

说明: 查询开始时间到结束时间这个时间段内已经发送完成的短信结果,支持查询最近90天的短信记录,最大查询时间区间为31天。

请求参数说明:

参数 说明 是否必填 类型

appId

应用id(短信-短信应用)

String

startTime

查询开始时间,ISO8601标准时间格式 UrlEncode(2021-02-12T00:00:00+08:00)

String

endTime

查询结束时间,ISO8601标准时间格式 UrlEncode(2021-02-12T23:59:59+08:00)

String

startIndex

查询的起始下标(单次查询默认最多返回50000个结果,超过50000分多次查询时可用到此字段)

否 (默认0)

Int

请求URL:

                      
                        https://api.onbuka.com/v3/getSentRcd?appId={appId}&startTime={startTime}&endTime={endTime}&startIndex={startIndex}
                      
                    

请求示例:

                      
                        RequestURL:
                          https://api.onbuka.com/v3/getSentRcd?appId=4luaKsL2&startTime=2021-02-12T00%3A00%3A00%2B08%3A00&endTime=2021-02-12T23%3A59%3A59%2B08%3A00&startIndex=0
                        RequestMethod:
                          GET
                        RequestHeaders:
                          Content-Type:application/json;charset=UTF-8
                          Sign:05d7a50893e22a5c4bb3216ae3396c7c
                          Timestamp:1630468800
                          Api-Key:bDqJFiq9
                      
                    

响应参数说明:

参数 说明 类型

status

状态码,0成功,其他失败参见状态码说明

String

reason

失败原因说明

String

success

发送成功的条数

String

fail

发送失败的条数

String

array

找到发送结果的json集合

JSONArray

msgId

提交号码对应平台msgId

String

number

提交号码

String

receiveTime

发送时间,ISO8601标准时间格式(2021-02-12T09:30:03+08:00)

String

status

发送状态:0发送成功,-1:发送中,1:发送失败

String

响应示例:

                      
                        {
                          "status": "0",
                          "reason": "success",
                          "success": "2",
                          "fail": "0",
                          "array": [
                            {
                              "msgId": "2108021054011000095",
                              "number": "91856321412",
                              "receiveTime": "2021-02-12T09:30:03+08:00",
                              "status": "0"
                            },
                            {
                              "msgId": "2108021059531000096",
                              "number": "91856321413",
                              "receiveTime": "2021-02-12T09:30:03+08:00",
                              "status": "0"
                            }
                          ]
                        }
                      
                    
 

意见反馈

0/500