# API统计信息查询-最近一段时间
#### 功能介绍
根据API的id和最近的一段时间查询API被调用的次数，统计周期为1分钟、小时、天。
- 查询范围一小时以内，一分钟一个样本，其样本值为一分钟内的累计值，服务器返回服务器的时间的上一分钟到往前推N分钟的数据；
- 查询范围一天以内，返回一小时一个样本，其样本值为一小时内的累计值，服务器会返回最近时长横跨统计周期的数据，比如时长为大于2小时，且小于3小时，那么会查询最近3个小时的数据；
- 查询超过一天以上，返回一天为一个样本，其样本值为一天内的累计值，服务器会返回最近时长横跨统计周期的数据。
![](https://support.huaweicloud.com/api-apig/public_sys-resources/note_3.0-zh-cn.png)
为了安全起见，在服务器上使用curl命令调用接口查询信息后，需要清理历史操作记录，包括但不限于"\~/.bash_history"、"/var/log/messages"（如有）。
#### URI
HTTP/HTTPS请求方法以及URI如下表所示。
表1HTTP/HTTPS请求方法以及URI 
| 请求方法 | URI                                                                        |
|:---|:---|
| GET  | /v1.0/apigw/statistics/api/latest?api_id=\[api_id\]\&duration=\[duration\] |
   
#### 请求消息
表2参数说明 
| 参数       | 是否必选 | 类型     | 说明                                      |
|:---|:---|:---|:---|
| api_id   | 是    | String | API的id                                  |
| duration | 是    | String | 最近统计时长，单位必须为h和m，比如1h和1m，分别代表最近1小时和最近1分钟 |
   
#### 响应消息
表3参数说明 
| 参数         | 类型      | 说明           | 操作类型 |
|:---|:---|:---|:---|
| code       | String  | 响应码          | R    |
| msg        | String  | 返回消息         | R    |
| start_time | Long    | 开始时间的UTC的时间戳 | R    |
| end_time   | Long    | 截止时间的UTC的时间戳 | R    |
| list       | 结构体数据类型 | 统计指标的数据结构结构体 | R    |
   
表4参数说明 
| 参数                  | 类型      | 说明                          | 操作类型 |
|:---|:---|:---|:---|
| cycle               | String  | 统计周期（预留）                    | R    |
| api_id              | String  | API的id                      | R    |
| current_minute      | Long    | API访问的UTC时间戳                | R    |
| group_id            | String  | API的分组ID                    | R    |
| provider            | String  | API拥有者                      | R    |
| req_count           | Integer | 请求总次数                       | R    |
| max_latency         | Integer | 最大延时                        | R    |
| avg_latency         | Double  | 平均耗时                        | R    |
| max_backend_latency | Integer | 最大后端延时                      | R    |
| avg_backend_latency | Double  | 平均后端延时                      | R    |
| max_inner_latency   | Integer | 最大网关内部延时                    | R    |
| avg_inner_latency   | Double  | 平均网关内部延时                    | R    |
| output_throughput   | Integer | 下行吞吐量（byte）                 | R    |
| input_throughput    | Integer | 上行吞吐量（byte）                 | R    |
| req_count4xx        | Integer | 4xx响应码总次数                   | R    |
| req_count5xx        | Integer | 5xx响应码总次数                   | R    |
| req_count2xx        | Integer | 2xx响应码总次数                   | R    |
| req_count_error     | Integer | 错误次数                        | R    |
| register_time       | String  | 记录时间（yyy-MM-dd HH:mm:ss）    | R    |
| req_time            | String  | API请求时间（yyy-MM-dd HH:mm:ss） | R    |
| status              | Integer | 状态-预留                       | R    |
   
响应消息样例：
```
{
    "code":"APIG.0000",
    "msg":"",
    "start_time":1524735000,
    "end_time":1524735000,
    "list":[
        {
            "api_id":"ae12b59fef2e4c6b8e01d44e98b738c0",
            "current_minute":1524735000,
            "group_id":"26463e4b2445415eabb55b2414012989",
            "provider":"d4ef919b31bd43d3927c5d46c71b68c4",
            "req_count":45,
            "max_latency":59,
            "avg_latency":2.53,
            "max_backend_latency":0,
            "avg_backend_latency":0,
            "max_inner_latency":59,
            "avg_inner_latency":2.53,
            "output_throughput":31815,
            "input_throughput":334474,
            "req_count4xx":0,
            "req_count5xx":0,
            "req_count2xx":45,
            "req_count_error":0,
            "register_time":"2018-04-26 17:30:48",
            "req_time":"2018-04-26 17:30:00",
            "status":1
        }
    ]
}
```
#### 状态码
表5返回消息说明 
| 状态码 | 说明            |
|:---|:---|
| 200 | Query Success |