
# 推送状态报告
#### 接口功能
IoT云通信主动向用户推送状态报告。
#### 接口地址
表1接口地址 
| **项目** | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|
| 消息方向   | IoT云通信-\> SP                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 方法     | HTTPS + POST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| URI    | https://**{IP:Port}**/common/sms/notifyReportMessage 说明： - **IP:Port**表示客户平台的IP和端口号，由客户提供给iTA平台，用于推送状态报告给客户。  - 该URI来源于"发送短信"接口请求消息中的"statusCallback"字段，详细解释请参见[发送短信](https://support.huaweicloud.com/api-iotcom/iotcom_05_0201.html)接口。   |
   
#### 请求消息
表2请求消息 
| **参数列表**    | **类型** | **必选/可选** | **最大长度** | **描述信息**                                                                                                                  |
|:---|:---|:---|:---|:---|
| requestId   | String | 可选        | 20       | 用于与下发消息时的requestId进行关联。                                                                                                   |
| mobile      | String | 必选        | 20       | 手机号码。与原始下发请求中的手机号码一致。以国家码开头。示例：8613600000000。 其中，国内短信可以不带国家码，示例：13600000000。 |
| messageId   | String | 必选        | 32       | 消息ID，与原始下发响应返回的messageId一致。                                                                                               |
| status      | String | 必选        | 10       | 短信下发状态码。                                                                                                                  |
| resultCode  | String | 可选        | 6        | 结果码。                                                                                                                      |
| resultDesc  | String | 可选        | 100      | 结果码描述。                                                                                                                    |
| smsCount    | int    | 可选        | 2        | 长短信拆分的条数。                                                                                                                 |
| receiveTime | String | 可选        | 36       | 终端用户收到短信的时间。                                                                                                              |
| 请求消息示例： { "messageId": "12345", "mobile": "12345678911", "receiveTime": "2016-05-29 10:55:23", "status": "DELIVED", "smsCount":2 } |||||
   
#### 响应消息
表3响应消息 
| **参数列表**   | **类型** | **必选/可选** | **最大长度** | **描述信息** |
|:---|:---|:---|:---|:---|
| resultCode | String | 必选        | 6        | 结果码。     |
| resultDesc | String | 可选        | 100      | 结果描述。    |
| 响应样例如下。 { "resultCode": "0" } |||||
   
