# 短信回执状态查询（推送）

### 1 短信回执状态查询
#### 请求URL
```
https://{domain}/sms/state?spid=xx&pwd=xx&timestamp=xx&msgid=xx
```

#### 请求方法
GET

#### 参数说明

| 字段      | 类型   | 名称            | 说明                                |
|----------|-------|----------------|-------------------------------------|
| spid     | string | 接口账号        |                                     |
| pwd      | string | 密码           | [接口说明3](/books/message-cn-api/page/4f6ff "接口说明")                      |
| timestamp | string | 当前Unix timestamp（秒） | 例： 1601028870             |
| msgid    | string | 消息ID（单次不超过100个） | 查询多个回执可用逗号连接如:100123,100124 |

#### 响应
```json
{
  "code": 0,
  "msg": "Success",
  "data": [{
    "msgid": "100123",
    "state": 0
  }]
}
```

#### 回执状态说明
state  0-无回执(已提交通道)，1-回执成功，2-回执失败

### 2 短信回执状态推送

#### 接口说明
通道返回回执后，通过配置的url通知客户短信回执内容，如需要可将url告诉我们进行配置

#### 请求URL
```
http(s)://{your_callback_url}?msgid=36160109669&das=628131565746&state=1
```

#### 请求方法
GET

#### 参数说明
- msgid   消息ID
- state   0-无回执(已提交通道)，1-回执成功，2-回执失败