
# 定义智能信息基础版发送回执
#### 功能介绍
用户按照接口规格实现智能信息基础版发送状态回执接口。接口规格包括请求方式、Header参数和Body参数。
![](https://support.huaweicloud.com/api-koomessage/public_sys-resources/note_3.0-zh-cn.png)
响应参数仅供参考，客户可以返回任意响应消息给平台，平台不会对响应消息处理。
#### URI
POST /v1/vms/send-callback
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                 |
|:---|:---|:---|:---|
| Content-Type | 是    | String | 请求体参数类型，该字段必须设置为：application/json。 |
   
表2请求Body参数 
| 参数      | 是否必选 | 参数类型                                                                    | 描述          |
|:---|:---|:---|:---|
| seq_id  | 否    | String                                                                  | 本次推送请求唯一标识。 |
| reports | 否    | Array of [SendReport] objects | 状态报告列表。     |
   
 表3SendReport 
| 参数      | 是否必选 | 参数类型    | 描述                                         |
|:---|:---|:---|:---|
| task_id | 否    | String  | 智能信息基础版发送任务ID。                             |
| mobile  | 否    | String  | 手机号，11位纯数字手机号码。样例：131\*\*\*\*0000。         |
| status  | 否    | Integer | 手机号用户下行消息接收状态。 - 0：成功 - 非0：失败              |
| code    | 否    | String  | 状态码。 说明： DELIVRD表示成功，其他表示失败。               |
| desc    | 否    | String  | 状态报告错误代码的描述。 - success：成功 - fail：失败        |
| stime   | 否    | String  | 本条状态报告所对应的下行消息发送时间。格式：YYYY-MM-DD HH:MM:SS。 |
| rtime   | 否    | String  | 状态报告返回时间。格式：YYYY-MM-DD HH:MM:SS。           |
   
#### 响应参数
无
#### 请求示例
定义智能信息基础版发送状态回执。发送任务ID为"8f782063-4366-44f5-8452-8a8a3a17abd2"，手机号为"131\*\*\*\*0000"，手机用户下行消息接收成功。
```
https://koomessage.myhuaweicloud.cn/v1/vms/send-callback
{
  "seq_id" : "0a96a1ac07a34e80b0e70569595e2c03",
  "reports" : [ {
    "task_id" : "8f782063-4366-44f5-8452-8a8a3a17abd2",
    "mobile" : "131****0000",
    "status" : 0,
    "code" : "DELIVRD",
    "desc" : "success",
    "stime" : "2022-11-06 20:38:33",
    "rtime" : "2022-11-06 20:38:35"
  } ]
}
```
#### 响应示例
无
#### 状态码
| 状态码 | 描述    |
|:---|:---|
| 200 | 返回信息。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-koomessage/ErrorCode.html)。
