
# 短信发送详情 - ListSmsDetails
#### 功能介绍
短信发送详情，接口仅支持开通短信套餐的中国移动与中国电信卡调用
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/GSL/doc?api=ListSmsDetails)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ocgsl/gsl_07_0026.html)。
#### URI
GET /v1/sms-send-infos/details
表1Query参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                    |
|:---|:---|:---|:---|
| limit      | 否    | Long   | 分页查询时每页显示的记录数，默认值为10，取值范围为10-500的整数 最小值：**10** 最大值：**500** 缺省值：**10** |
| offset     | 否    | Long   | 分页查询时的页码数，默认值为1，取值范围为1-1000000的整数 最小值：**1** 最大值：**1000000** 缺省值：**1** |
| cid        | 否    | String | 容器ID                                                                  |
| start_time | 否    | String | 开始时间                                                                  |
| end_time   | 否    | String | 结束时间                                                                  |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。通过调用IAM服务 [获取IAM用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取，接口返回的响应消息头中"X-Subject-Token"就是需要获取的用户Token。简要的获取方法样例请参见 [Token认证](https://support.huaweicloud.com/api-ocgsl/gsl_07_0004.html)。 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数          | 参数类型                                                                                                                               | 描述                                                    |
|:---|:---|:---|
| limit       | Long                                                                                                                               | 每页的记录数 最小值：**10** 最大值：**500**                         |
| offset      | Long                                                                                                                               | 页码，最小值是1，最大值为1000000。默认值是1. 最小值：**1** 最大值：**1000000** |
| count       | Long                                                                                                                               | 记录总数 最小值：**0**                                        |
| sms_details | Array of [SmsSendDetailQueryVo] objects | 短信发送详情列表                                              |
   
 表4SmsSendDetailQueryVo 
| 参数            | 参数类型    | 描述                   |
|:---|:---|:---|
| cid           | String  | 容器ID                 |
| msisdn        | String  | MSISDN 最大长度：**32**   |
| sent_time     | String  | 发送时间                 |
| received_time | String  | 接收时间                 |
| sms_status    | Integer | 短信状态:1发送中 2.已送达 3.失败 |
| sms_content   | String  | 短信内容 最大长度：**1024**   |
   
#### 请求示例
查询短信发送详情，每页返回10条数据，从第1页开始。
```
GET https://{endpoint}/v1/sms-send-infos/details?offset=1&limit=10
```
#### 响应示例
**状态码：200**
OK
```
{
  "limit" : 10,
  "offset" : 1,
  "count" : 1,
  "sms_details" : [ {
    "cid" : "11669563150033768257",
    "msisdn" : "861400190692085",
    "sent_time" : "2022-03-22T00:00:00.000+00:00",
    "received_time" : "2022-03-22T00:00:00.000+00:00",
    "sms_status" : 2,
    "sms_content" : "testadd321"
  } ]
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ocgsl/ErrorCode.html)。
