拉取状态报告

拉取状态报告（PullSmsReport）

描述

拉取短信状态报告

建议: 使用HTTP推送功能，获取状态报告。
使用拉取功能可能存在状态报告丢失的情况，
比如：网络超时，客户拉取状态报告服务自身处理异常等

HTTP METHOD

GET

请求参数

公共参数列表 详情

名称	类型	必须	长度限制(字符)	参数格式	描述	备注
Action	String	是	确定值	[a-zA-Z]+	操作接口名，系统规定参数，取值：PullSmsReport
Version	String	是	确定值		版本号，系统规定参数，取值：2019-05-01
Size	Integer	否			每次拉取个数，默认（最大）500
IsInternational	Integer	否			默认拉取国内短信，如果拉取国际短信状态，此参数需要传值1

示例（调用成功）

请求示例

https://ksms.ksyun.com/?Action=PullSmsReport&Version=2019-05-01&业务参数

返回示例

{
    "RequestId": "68a911b6-aa32-4edd-9327-e7cbdbbbf394",
    "Data": [
        {
            "SendTime": "2020-06-05 14:47:02",
            "ReceiveTime": "2020-06-05 14:47:02",
            "Sid": "e8bd2ba7e2711591339622",
            "NationCode": "86",
            "ExtId": "asd123",
            "ErrDesc": "停机、无法接通",
            "Status": "FAIL",
            "ErrCode": "SERVICE_ERROR",
            "NationEnCode": "CN",
            "SmsType": 2,
            "Mobile": "1xxxxxxxxxx",
            "SmsTotal": 1
        },
        {
            "SendTime": "2020-06-05 15:13:14",
            "ReceiveTime": "2020-06-05 15:13:14",
            "Sid": "1caef0622c101591341194",
            "NationCode": "86",
            "ExtId": "asd123",
            "ErrDesc": "停机、无法接通",
            "Status": "FAIL",
            "ErrCode": "109",
            "NationEnCode": "CN",
            "SmsType": 2,
            "Mobile": "1xxxxxxxxxx",
            "SmsTotal": 2
        }
    ]
}

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