短信状态报告接口 - 智想云短信平台 | 实时短信投递状态查询API

接口说明

本接口用于主动获取短信发送的状态报告。相同的状态报告，只能获取一次。

接口地址

POST http://cloud.thinksms.cn/statusApi.aspx

Content-Type: application/x-www-form-urlencoded

提示：建议每5-10分钟获取一次状态报告，避免频繁请求对系统造成压力

请求参数

参数名称	含义	类型	必填	说明
action	请求动作	string	是	固定为:query
userid	企业ID	string	是	企业ID（登陆后台-客户管理-我的信息）
account	帐号	string	是	短信帐号
password	密码	string	是	登陆密码
statusNum	获取数量	number	否	必须为数字，默认4000，可不填
rt	返回格式	string	否	固定值：json，不填则为XML格式返回

请求示例

JSON格式请求：

http://cloud.thinksms.cn/statusApi.aspx?action=query&rt=json&userid=企业ID&account=账号&password=密码
            

XML格式请求：

http://cloud.thinksms.cn/statusApi.aspx?action=query&userid=企业ID&account=账号&password=密码
            

响应数据

JSON格式响应：

{
    "ReturnStatus": "Success",
    "Message": "OK",
    "Task": [
        {
            "Mobile": "13800138000",
            "TaskID": "358",
            "Status": "20",
            "ReceiveTime": "2018-08-20 11:20:18",
            "ErrorCode": "UNDELIVERED",
            "ExtNo": ""
        },
        {
            "Mobile": "13800138001",
            "TaskID": "358",
            "Status": "20",
            "ReceiveTime": "2018-08-20 11:20:18",
            "ErrorCode": "UNDELIVERED",
            "ExtNo": ""
        }
    ]
}
            

XML格式响应：

    Success
    OK
    
        13800138000
        358
        20
        2018-08-20 11:20:18
        UNDELIVERED
        
    
    
        13800138001
        358
        20
        2018-08-20 11:20:18
        UNDELIVERED
        
    

            

字段说明

ReturnStatus/returnstatus 返回状态值：成功返回Success，失败返回：Faild

Message/message 描述信息

Task/task 状态报告数组队列

Mobile/mobile 对应的手机号码

TaskID/taskid 同一批任务ID

Status/status 状态报告：10=发送成功，20=发送失败

ReceiveTime/receivetime 接收时间

ErrorCode/errorcode 上级网关返回值，不同网关返回值不同，仅作为参考

ExtNo/extno 子号，即自定义扩展号

错误返回值

{
    "ReturnStatus": "Faild",
    "Message": "用户名或密码错误"
}
            

状态码说明

主要状态码

状态码	含义	说明
10	发送成功	短信已成功送达用户手机
20	发送失败	短信发送失败，具体原因见ErrorCode

常见ErrorCode错误码

错误码	含义	建议处理方式
UNDELIVERED	未送达	可能用户关机或不在服务区，建议稍后重试
REJECTED	被拒绝	可能被运营商或用户拦截
EXPIRED	已过期	短信在网关中停留时间过长
UNKNOWN	未知错误	需要联系技术支持排查