{
  "openapi": "3.1.0",
  "info": {
    "title": "Quản Lý Điện — API dữ liệu điện Việt Nam",
    "version": "1.0.0",
    "description": "API tĩnh, miễn phí, không cần đăng ký hay API key: giá điện sinh hoạt bậc thang theo quyết định của Bộ Công Thương, và công suất tham khảo thiết bị điện gia đình. Mỗi response tự mô tả nguồn, ngày cập nhật và giấy phép. URL /v1/ giữ nguyên vĩnh viễn — xem quy tắc sử dụng tại https://quanlydien.com/api/.",
    "license": {
      "name": "CC BY 4.0 — ghi nguồn quanlydien.com khi dùng lại",
      "url": "https://creativecommons.org/licenses/by/4.0/"
    },
    "contact": {
      "name": "Quản Lý Điện",
      "url": "https://quanlydien.com/doi-tac/",
      "email": "doitac@quanlydien.com"
    }
  },
  "servers": [
    { "url": "https://quanlydien.com", "description": "Production" }
  ],
  "paths": {
    "/api/v1/gia-dien.json": {
      "get": {
        "operationId": "getGiaDienBacThang",
        "summary": "Giá điện sinh hoạt bậc thang hiện hành",
        "description": "Biểu giá bán lẻ điện sinh hoạt bậc thang đang áp dụng tại Việt Nam, theo quyết định của Bộ Công Thương, kèm số quyết định, ngày hiệu lực và nguồn tham chiếu.",
        "responses": {
          "200": {
            "description": "Biểu giá điện sinh hoạt bậc thang hiện hành",
            "content": {
              "application/json": {
                "example": {
                  "version": "v1",
                  "loai": "sinh-hoat-bac-thang",
                  "don_vi": "VND/kWh",
                  "hieu_luc_tu": "2025-05-10",
                  "cap_nhat": "2026-09-15",
                  "giay_phep": "CC BY 4.0 — dùng lại tự do, chỉ cần ghi nguồn quanlydien.com",
                  "bac": [
                    { "bac": 1, "tu_kwh": 0, "den_kwh": 50, "gia": 1984 },
                    { "bac": 2, "tu_kwh": 51, "den_kwh": 100, "gia": 2050 }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/gia-dien-lich-su.json": {
      "get": {
        "operationId": "getGiaDienLichSu",
        "summary": "Lịch sử các biểu giá điện sinh hoạt trước đó",
        "description": "Lưu trữ các biểu giá điện sinh hoạt bậc thang trước đó — chỉ thêm bản ghi mới khi có quyết định mới, không sửa/xoá bản ghi cũ. Cấu trúc mỗi phần tử giống hệt /api/v1/gia-dien.json.",
        "responses": {
          "200": {
            "description": "Danh sách các biểu giá điện sinh hoạt đã hết hiệu lực",
            "content": {
              "application/json": {
                "example": { "version": "v1", "cap_nhat": "2026-09-15", "lich_su": [] }
              }
            }
          }
        }
      }
    },
    "/api/v1/thiet-bi.json": {
      "get": {
        "operationId": "getCongSuatThietBi",
        "summary": "Công suất tham khảo thiết bị điện gia đình",
        "description": "Công suất tham khảo (W), min–max, của các thiết bị điện gia đình phổ biến tại Việt Nam — máy lạnh, tủ lạnh, bình nóng lạnh, máy giặt... Không phải số đo chính thức của EVN, chỉ mang tính tham khảo.",
        "responses": {
          "200": {
            "description": "Danh sách công suất tham khảo thiết bị",
            "content": {
              "application/json": {
                "example": {
                  "version": "v1",
                  "don_vi": "W",
                  "cap_nhat": "2026-09-15",
                  "thiet_bi": [
                    { "ten": "Máy lạnh 1HP / 9.000 BTU", "cong_suat_min": 700, "cong_suat_max": 850 }
                  ]
                }
              }
            }
          }
        }
      }
    }
  }
}