API统计信息查询-最近一段时间

功能介绍

根据API的id和最近的一段时间查询API被调用的次数，统计周期为1分钟、小时、天。

查询范围一小时以内，一分钟一个样本，其样本值为一分钟内的累计值，服务器返回服务器的时间的上一分钟到往前推N分钟的数据；
查询范围一天以内，返回一小时一个样本，其样本值为一小时内的累计值，服务器会返回最近时长横跨统计周期的数据，比如时长为大于2小时，且小于3小时，那么会查询最近3个小时的数据；
查询超过一天以上，返回一天为一个样本，其样本值为一天内的累计值，服务器会返回最近时长横跨统计周期的数据。

为了安全起见，在服务器上使用curl命令调用接口查询信息后，需要清理历史操作记录，包括但不限于“~/.bash_history”、“/var/log/messages”（如有）。

URI

HTTP/HTTPS请求方法以及URI如下表所示。

表1 HTTP/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
        }
    ]
}