Data API

数据 API 用于查询、导出和管理 USV 采集的数据。

遥测数据

查询遥测数据

GET /api/v1/data/telemetry

查询参数:

• device - 设备 ID（必需）
• start - 开始时间（ISO 8601）
• end - 结束时间（ISO 8601）
• since - 相对时间（如 “1h”, “30m”）
• limit - 返回记录数

示例:

curl -X GET \
  'http://localhost:8080/api/v1/data/telemetry?device=USV-2024-001&since=1h&limit=100' \
  -H 'Authorization: Bearer <token>'

响应:

{
  "success": true,
  "data": [
    {
      "timestamp": "2024-01-15T10:30:00Z",
      "latitude": 31.2304,
      "longitude": 121.4737,
      "altitude": 0,
      "speed": 5.2,
      "heading": 90,
      "battery": 78
    },
    ...
  ]
}

传感器数据

查询传感器数据

GET /api/v1/data/sensors

查询参数:

• device - 设备 ID
• type - 传感器类型
• parameter - 参数名称
• start / end - 时间范围

示例:

curl -X GET \
  'http://localhost:8080/api/v1/data/sensors?device=USV-2024-001&type=water_quality&parameter=ph'

数据导出

导出数据

POST /api/v1/data/export

请求体:

{
  "device_id": "USV-2024-001",
  "data_type": "sensors",
  "format": "csv",
  "start_time": "2024-01-15T00:00:00Z",
  "end_time": "2024-01-15T23:59:59Z"
}

查看更多请访问 数据管理指南。