Skip to main content

Stations API

API quản lý trạm quan trắc.

Danh sách trạm​

GET /api/v1/stations

Response:

{
  "data": [
    {
      "id": "uuid",
      "name": "Trạm Hoàn Kiếm",
      "externalId": "HN-HK-001",
      "city": "Hà Nội",
      "country": "VN",
      "location": {
        "type": "Point",
        "coordinates": [105.8542, 21.0285]
      },
      "priority": "HIGH",
      "isActive": true,
      "inMaintenance": false,
      "createdAt": "2025-01-01T00:00:00Z"
    }
  ]
}

Trạm đang hoạt động​

GET /api/v1/stations/active

Tìm trạm gần nhất theo GPS​

GET /api/v1/stations/nearest

Query Parameters:

ParamTypeRequiredDescription
latnumberYesVĩ độ
lonnumberYesKinh độ

Thống kê trạm​

GET /api/v1/stations/stats
Authorization: Bearer <ADMIN_TOKEN>

Response:

{
  "total": 4,
  "active": 4,
  "inactive": 0,
  "maintenance": 0,
  "byCity": [{ "city": "Hà Nội", "count": 4 }],
  "byPriority": [
    { "priority": "HIGH", "count": 2 },
    { "priority": "MEDIUM", "count": 2 }
  ]
}

Chi tiết trạm​

GET /api/v1/stations/:id

Tạo trạm mới (Admin)​

POST /api/v1/stations
Authorization: Bearer <ADMIN_TOKEN>
Content-Type: application/json

{
  "name": "Trạm Hoàn Kiếm",
  "externalId": "HN-HK-001",
  "city": "Hà Nội",
  "country": "VN",
  "latitude": 21.0285,
  "longitude": 105.8542,
  "priority": "HIGH"
}

Cập nhật trạm (Admin)​

PUT /api/v1/stations/:id
Authorization: Bearer <ADMIN_TOKEN>
Content-Type: application/json

{
  "name": "Trạm Hoàn Kiếm - Updated",
  "priority": "MEDIUM"
}

Xóa trạm (Admin)​

DELETE /api/v1/stations/:id
Authorization: Bearer <ADMIN_TOKEN>

Đặt trạm vào chế độ bảo trì (Admin)​

POST /api/v1/stations/:id/maintenance
Authorization: Bearer <ADMIN_TOKEN>
Content-Type: application/json

{
  "inMaintenance": true
}

Kích hoạt trạm​

POST /api/v1/stations/:id/activate
Authorization: Bearer <ADMIN_TOKEN>

Vô hiệu hóa trạm​

POST /api/v1/stations/:id/deactivate
Authorization: Bearer <ADMIN_TOKEN>