查询短信记录

查询短信记录（QuerySmsDetail）

描述

查询短信记录

HTTP METHOD

GET

请求参数

公共参数列表 详情

名称	类型	必须	长度限制(字符)	参数格式	描述	备注
Action	String	是	确定值	[a-zA-Z]+	操作接口名，系统规定参数，取值：QuerySmsDetail
Version	String	是	确定值		版本号，系统规定参数，取值：2019-05-01
SendDate	String	是			短信记录的发送日期，例：2020-10-01
Mobile	String	否		[0-9]+	手机号: 国内 11位数字，例如 1xxxxxxxxxx。国际 : +国家代号手机号码，例如 +861xxxxxxxxxx
Sid	String	否			发短信接口返回的发送标识Sid
ExtId	String	否			客户自定义流水号

返回结果

通过指定 Accept:application/json，返回的数据格式为json

参数	描述
Sid	发短信接口返回的发送标识Sid
NationCode	国家（或地区）码，数字
ErrCode	短信状态码
Status	短信接收状态，SUCCESS（成功）、FAIL（失败）
NationEnCode	国家（或地区）码，英文
SendTime	短信发送时间
Mobile	手机号
ReceiveTime	用户实际接收到短信的时间
ExtId	客户下发短信时的自定义流水号
SmsType	短信类型
SmsTotal	长短信拆分后的条数

请求示例

https://ksms.ksyun.com/?Action=QuerySmsDetail&Version=2019-05-01&SendDate=2020-10-01&Mobile=13500000000&Signature=xxxx&SignatureVersion=1.0&Timestamp=2019-08-13T17:18:36Z&Service=ksms&Accesskey=xxx

响应成功返回示例

{
    "RequestId": "68a911b6-aa32-4edd-9327-e7cbdbbbf394",
    "Data": [
        {
            "SmsTotal": 5,
            "SendTime": "2020-10-01 16:00:20",
            "ReceiveTime": "2020-10-01 16:00:29",
            "Sid": "23ab28a0331605513620",
            "NationCode": "86",
            "ExtId": "test1234",
            "Status": "SUCCESS",
            "ErrCode": "DELIVRD",
            "NationEnCode": "CN",
            "SmsType": 1,
            "Mobile": "1xxxxxxxxxx"
        },
        {
            "SmsTotal": 5,
            "SendTime": "2020-10-01 16:00:16",
            "ReceiveTime": "2020-10-01 16:00:23",
            "Sid": "e93d2fc4c61605513616",
            "NationCode": "86",
            "ExtId": "test1234",
            "Status": "SUCCESS",
            "ErrCode": "DELIVRD",
            "NationEnCode": "CN",
            "SmsType": 1,
            "Mobile": "1xxxxxxxxxx"
        }
    ]
}