---
title: "获取时间序列数据"
method: GET
path: "/api/v1/stats/time-series"
tags: ["统计信息"]
---

# 获取时间序列数据

`GET /api/v1/stats/time-series`

获取指定时间范围和指标类型的时间序列数据，用于图表展示

## Query parameters

- `timeRange` '24h' | '7d' | '30d', required
- `metric` 'requests' | 'blocks', required

## Response `200`

获取时间序列数据成功

- object — 成功的API响应标准格式
  - `code` integer
  - `data` DtoTimeSeriesResponse — 时间序列图表数据响应
    - `data` DtoTimeSeriesDataPoint[] — 数据点列表
      - `timestamp` string — 时间戳，表示数据点的时间
      - `value` integer — 数值，表示该时间点的指标值
    - `metric` string — 指标名称
    - `timeRange` string — 时间范围
  - `message` string
  - `requestId` string
  - `success` boolean
  - `timestamp` string

## Other responses

- `400` — 请求参数错误
- `401` — 未授权访问
- `500` — 服务器内部错误

---

[API](https://skmtc.net/labring/apis/ruiqi-waf-api.md) · [All operations](https://skmtc.net/labring/apis/ruiqi-waf-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/labring/ruiqi-waf-api/revisions/aaacd7e06a88/schema)