{
  "success": true,
  "name": "API Lịch Thủy Triều Việt Nam",
  "version": "1.0.0",
  "base_url": "https://lichthuytrieu.arxivy.app/api",
  "description": "Mực nước theo giờ (0h–23h, mét) tại 15 địa danh ven biển Việt Nam, kèm ngày âm lịch, đỉnh triều và chân triều. Dữ liệu hiện có: 01/01/2026 – 31/10/2026.",
  "endpoints": [
    {
      "method": "GET",
      "path": "/api/health",
      "desc": "Kiểm tra API đang sống"
    },
    {
      "method": "GET",
      "path": "/api/locations",
      "desc": "Danh sách 15 địa danh (slug, tên, tỉnh, vùng)"
    },
    {
      "method": "GET",
      "path": "/api/today",
      "desc": "Dữ liệu hôm nay (Asia/Saigon), mọi địa danh"
    },
    {
      "method": "GET",
      "path": "/api/tide/{date}",
      "example": "/api/tide/2026-10-24",
      "desc": "Dữ liệu 1 ngày (YYYY-MM-DD), mọi địa danh"
    },
    {
      "method": "GET",
      "path": "/api/tide/{date}/{location}",
      "example": "/api/tide/2026-10-24/sai-gon",
      "desc": "Dữ liệu 1 ngày, 1 địa danh"
    },
    {
      "method": "GET",
      "path": "/api/tide?date={date}&location={slug}",
      "example": "/api/tide?date=2026-10-24&location=sai-gon",
      "desc": "Dạng query của 2 endpoint trên"
    },
    {
      "method": "GET",
      "path": "/api/range?location={slug}&from={date}&to={date}",
      "example": "/api/range?location=sai-gon&from=2026-10-24&to=2026-10-30",
      "desc": "Nhiều ngày liên tiếp, tối đa 31 ngày, 1 địa danh"
    },
    {
      "method": "GET",
      "path": "/api/month?location={slug}&year={yyyy}&month={mm}",
      "example": "/api/month?location=sai-gon&year=2026&month=10",
      "desc": "Tóm tắt cả tháng: max/min + đỉnh/chân triều mỗi ngày"
    }
  ],
  "notes": [
    "Mực nước tính bằng mét (m), thời gian theo giờ địa phương (h).",
    "CORS mở (*), không cần key.",
    "Phản hồi có cache ở edge, dữ liệu lịch sử không đổi."
  ]
}