title: 查询发送状态

title: 查询发送状态

用于查询短信发送状态，调用时需要计算 数字签名 。

目前查询短信状态提供以下两种查询接口：

批量查询已发送短信状态

适用场景 此接口批量返回24小时内最新的短信发送状态。 例如某用户发送了1000条短信后调用此接口，如果调用接口时已经有300条短信发送状态，则接口会一次性返回这些发送状态。之后再次调用此接口时，会返回去除之前已获取到的300条状态之外的尚未给用户返回的新短信发送状态。 如果短信发送状态在产生后超出24小时未通过此接口获取，可以通过使用rrid查询某批次短信状态接口进行发送状态查询。

URL

https://sms.wilddog.com/api/v2/{:SMSAppID}/status
此接口限制每appid每秒调用一次

返回数据格式

JSON

HTTP 请求方式

GET

参数说明

返回说明

data中返回JSONArray,格式如下(其中status取值:0-未发送,1-发送中,2-发送成功,3-发送失败; deliveryStatus为运营商返回状态)
{
    "status": "ok",
     data": [
        {
            "status": 2,
            "mobile": "13800138000",
            "receiveTime": "2016-11-22 20:18:50",
            "rrid": "e97539af58f44a0092",
            "deliveryStatus":"DELIVRD"
        }
    ]
}

示例代码

curl -X POST https://sms.wilddog.com/api/v2/myoffice1/send 
-d "signature=$signature&timestamp=$timestamp"

使用RRID查询某批次短信状态

适用场景 通过rrid查询某一具体批次时适合使用此接口。由于调用接口时可能短信发送状态尚未返回，需要轮询接口不断查询。获取到发送状态后应该停止此rrid的轮询。 一般地，推荐使用批量查询已发送短信状态接口进行状态查询操作。

URL

https://sms.wilddog.com/api/v1/{:SMSAppID}/status

返回数据格式

JSON

HTTP 请求方式

GET

参数说明

返回说明

data中返回JSONArray,格式如下(其中status取值:0-未发送,1-发送中,2-发送成功,3-发送失败; deliveryStatus为运营商返回状态)
{
    "status": "ok",
     data": [
        {
            "status": 2,
            "mobile": "13800138000",
            "receiveTime": "2016-11-22 20:18:50",
            "rrid": "e97539af58f44a0092",
            "deliveryStatus":"DELIVRD"
        }
    ]
}

示例代码

curl -X POST https://sms.wilddog.com/api/v1/myoffice1/send 
-d "signature=$signature&rrid=$rrid"

状态码 部分运营商状态码如下：