{"openapi":"3.1.0","info":{"title":"API dữ liệu mở - Hệ thống WebGIS cảnh báo nguy cơ ngập lụt tỉnh Hà Tĩnh","version":"1.0.0","description":"Đề tài QĐ 529/QĐ-SKHCN ngày 06/11/2024. Mọi điểm cuối dưới đây công khai, chỉ đọc (trừ identify, phân tích vùng, hỏi đáp dùng POST).\n\nBản đồ là nguy cơ (khả năng tương đối bị ngập), không phải dự báo ngập thời gian thực. Tín hiệu cảnh báo chỉ mang tính tham khảo.\n\nDịch vụ OGC công khai (chỉ GET): WMS 1.3.0 tại /geoserver/hatinh/wms (GetCapabilities, GetMap, GetLegendGraphic, GetFeatureInfo); WMTS 1.0.0 tại /geoserver/gwc/service/wmts. Tên lớp hatinh:<ma>. WFS không mở ra Internet; vector công khai tải qua /api/public/xa/geojson và /api/public/layers/{ma}/tai-ve.\n\nLỗi luôn là JSON { error, chi_tiet? } với mã snake_case tiếng Việt không dấu."},"servers":[{"url":"/"}],"tags":[{"name":"Thống kê"},{"name":"Xã/phường"},{"name":"Kịch bản"},{"name":"Lớp dữ liệu"},{"name":"Cảnh báo"},{"name":"Bản đồ"},{"name":"Thư viện bản đồ"},{"name":"Trợ lý AI"},{"name":"Hệ thống"}],"paths":{"/api/public/stats/tinh":{"get":{"tags":["Thống kê"],"summary":"Thống kê toàn tỉnh của một lớp nguy cơ (mặc định lớp chính thức)","operationId":"get_api_public_stats_tinh","parameters":[{"name":"lop_ma","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9_]{2,60}$"}}],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatsTinh"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/stats/xa":{"get":{"tags":["Thống kê"],"summary":"Xếp hạng 69 xã theo một chỉ tiêu","operationId":"get_api_public_stats_xa","parameters":[{"name":"lop_ma","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9_]{2,60}$"}},{"name":"chi_tieu","in":"query","required":true,"schema":{"type":"string","enum":["km2_cao_rat_cao","ty_le_cao_rat_cao_pct","dan_so_phoi_nhiem","ty_le_tung_ngap_pct","mua_nam_tb_mm","rx5day_max_mm"]}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["asc","desc"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":69}}],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatsXaRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/stats/xa/xuat":{"get":{"tags":["Thống kê"],"summary":"Tải CSV 69 xã (UTF-8 có BOM)","operationId":"get_api_public_stats_xa_xuat","parameters":[{"name":"lop_ma","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9_]{2,60}$"}},{"name":"dinh_dang","in":"query","required":true,"schema":{"type":"string","const":"csv"}}],"responses":{"200":{"description":"Tệp CSV 69 dòng","content":{"text/csv":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/stats/su-kien-ngap":{"get":{"tags":["Thống kê"],"summary":"Danh mục sự kiện ngập (Sentinel-1, UNOSAT, Copernicus EMS)","operationId":"get_api_public_stats_su_kien_ngap","parameters":[],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuKienNgapListRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/stats/huyen-cu":{"get":{"tags":["Thống kê"],"summary":"Phụ lục đối chiếu huyện cũ với 69 xã/phường mới","operationId":"get_api_public_stats_huyen_cu","parameters":[],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HuyenCuDoiChieuRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/xa":{"get":{"tags":["Xã/phường"],"summary":"Danh sách 69 xã/phường kèm chỉ số nguy cơ","operationId":"get_api_public_xa","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":100}},{"name":"huyen_cu","in":"query","required":false,"schema":{"type":"string","maxLength":60}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["ten","ty_le_cao","phoi_nhiem"]}},{"name":"lop_ma","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9_]{2,60}$"}}],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/XaListRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/xa/geojson":{"get":{"tags":["Xã/phường"],"summary":"GeoJSON 69 xã (đơn giản hoá; day_du=1 để lấy hình học đầy đủ)","operationId":"get_api_public_xa_geojson","parameters":[{"name":"lop_ma","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9_]{2,60}$"}},{"name":"day_du","in":"query","required":false,"schema":{"type":"string","enum":["0","1"]}}],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/XaFeatureCollection"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/xa/{ma}":{"get":{"tags":["Xã/phường"],"summary":"Hồ sơ một xã/phường","operationId":"get_api_public_xa_ma","parameters":[{"name":"ma","in":"path","required":true,"description":"Mã xã (vd phuong_bac_hong_linh)","schema":{"type":"string"},"example":"phuong_bac_hong_linh"},{"name":"lop_ma","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9_]{2,60}$"}}],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/XaDetailRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"404":{"description":"Không tìm thấy (khong_tim_thay)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/kich-ban":{"get":{"tags":["Kịch bản"],"summary":"Nguy cơ theo 4 kịch bản CMIP6, phân tách bất định, đường đáp ứng theo hệ số mưa","operationId":"get_api_public_kich_ban","parameters":[{"name":"mo_hinh","in":"query","required":false,"schema":{"type":"string","enum":["xgb","dnn"]}}],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KichBanListRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/kich-ban/{ma}":{"get":{"tags":["Kịch bản"],"summary":"Một kịch bản và chênh lệch từng xã so với thời kỳ nền","operationId":"get_api_public_kich_ban_ma","parameters":[{"name":"ma","in":"path","required":true,"description":"nen | ssp245_giua | ssp585_giua | ssp245_cuoi | ssp585_cuoi","schema":{"type":"string"},"example":"ssp585_cuoi"},{"name":"mo_hinh","in":"query","required":false,"schema":{"type":"string","enum":["xgb","dnn"]}}],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KichBanDetailRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"404":{"description":"Không tìm thấy (khong_tim_thay)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/layers":{"get":{"tags":["Lớp dữ liệu"],"summary":"Danh mục lớp (id lớp dùng chung với GeoServer hatinh:<ma>); đăng nhập vai trò nội bộ thấy thêm lớp thử nghiệm Model Lab","operationId":"get_api_public_layers","parameters":[{"name":"nhom","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LayersRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/layers/{ma}":{"get":{"tags":["Lớp dữ liệu"],"summary":"Thông tin một lớp và lịch sử phiên bản theo năm","operationId":"get_api_public_layers_ma","parameters":[{"name":"ma","in":"path","required":true,"description":"Mã lớp (ADR-17)","schema":{"type":"string"},"example":"nguy_co_dnn_cap"}],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LayerDetailRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"404":{"description":"Không tìm thấy (khong_tim_thay)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/layers/{ma}/tai-ve":{"get":{"tags":["Lớp dữ liệu"],"summary":"Tải tệp lớp (COG hoặc GPKG) khi lớp cho phép tải","operationId":"get_api_public_layers_ma_tai_ve","parameters":[{"name":"ma","in":"path","required":true,"description":"Mã lớp","schema":{"type":"string"},"example":"nguy_co_dnn_cap"},{"name":"nam","in":"query","required":false,"schema":{"type":"integer","minimum":1990,"maximum":2100}}],"responses":{"200":{"description":"Tệp COG (raster) hoặc GPKG (vector); 403 nếu lớp không cho tải","content":{"image/tiff":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"404":{"description":"Không tìm thấy (khong_tim_thay)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/canh-bao":{"get":{"tags":["Cảnh báo"],"summary":"Tín hiệu nguy cơ tham khảo đang hiệu lực và liên kết bản tin chính thức","operationId":"get_api_public_canh_bao","parameters":[],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CanhBaoPublicList"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/canh-bao/lich-su":{"get":{"tags":["Cảnh báo"],"summary":"Lịch sử các đợt tín hiệu đã ban hành","operationId":"get_api_public_canh_bao_lich_su","parameters":[{"name":"page","in":"query","required":false,"schema":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991}},{"name":"size","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"tu","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"den","in":"query","required":false,"schema":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},{"name":"xa_ma","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CanhBaoLichSuRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/canh-bao/{id}":{"get":{"tags":["Cảnh báo"],"summary":"Chi tiết một đợt đã ban hành","operationId":"get_api_public_canh_bao_id","parameters":[{"name":"id","in":"path","required":true,"description":"UUID đợt cảnh báo","schema":{"type":"string"}}],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CanhBaoPublicDetailRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"404":{"description":"Không tìm thấy (khong_tim_thay)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/identify":{"post":{"tags":["Bản đồ"],"summary":"Giá trị các lớp tại một điểm (cấp, xác suất, xã)","description":"Giới hạn: 60 lần/phút/IP.","operationId":"post_api_public_identify","parameters":[],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentifyRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"429":{"description":"Vượt giới hạn tần suất (qua_nhieu_yeu_cau), có header Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentifyReq"}}}}}},"/api/public/phan-tich-vung":{"post":{"tags":["Bản đồ"],"summary":"Diện tích từng cấp nguy cơ, dân số, đất canh tác trong một xã hoặc đa giác","description":"Giới hạn: 20 lần/phút/IP; đa giác ≤ 500 km², ≤ 2.000 đỉnh.","operationId":"post_api_public_phan_tich_vung","parameters":[],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhanTichVungRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"429":{"description":"Vượt giới hạn tần suất (qua_nhieu_yeu_cau), có header Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhanTichVungReq"}}}}}},"/api/public/tim-kiem":{"get":{"tags":["Bản đồ"],"summary":"Tìm xã, địa danh, toạ độ WGS84 hoặc VN-2000","description":"Giới hạn: 60 lần/phút/IP.","operationId":"get_api_public_tim_kiem","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":100}}],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimKiemRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"429":{"description":"Vượt giới hạn tần suất (qua_nhieu_yeu_cau), có header Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/ban-do-pdf":{"get":{"tags":["Thư viện bản đồ"],"summary":"Danh mục bản đồ PDF dựng sẵn (toàn tỉnh, 7 huyện cũ, 69 xã)","operationId":"get_api_public_ban_do_pdf","parameters":[{"name":"loai","in":"query","required":false,"schema":{"type":"string","enum":["tinh","huyen_cu","xa"]}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":100}}],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BanDoPdfListRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/ban-do-pdf/{id}":{"get":{"tags":["Thư viện bản đồ"],"summary":"Tải một bản đồ PDF (xem=1 để xem trong trình duyệt)","operationId":"get_api_public_ban_do_pdf_id","parameters":[{"name":"id","in":"path","required":true,"description":"UUID bản đồ","schema":{"type":"string"}},{"name":"xem","in":"query","required":false,"schema":{"type":"string","enum":["1"]}}],"responses":{"200":{"description":"Tệp PDF","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"404":{"description":"Không tìm thấy (khong_tim_thay)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}},"/api/public/hoi-dap":{"post":{"tags":["Trợ lý AI"],"summary":"Hỏi đáp có số liệu và trích nguồn (503 khi trợ lý chưa được cấu hình)","description":"Giới hạn: 10 lần/phút/IP, 200 lần/ngày toàn hệ thống.","operationId":"post_api_public_hoi_dap","parameters":[],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoiDapRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"429":{"description":"Vượt giới hạn tần suất (qua_nhieu_yeu_cau), có header Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HoiDapReq"}}}}}},"/api/health":{"get":{"tags":["Hệ thống"],"summary":"Kiểm sống dịch vụ","operationId":"get_api_health","parameters":[],"responses":{"200":{"description":"Thành công","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthRes"}}}},"400":{"description":"Tham số không hợp lệ (du_lieu_khong_hop_le)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}},"503":{"description":"Dịch vụ tạm ngưng (dich_vu_tam_ngung, ai_khong_kha_dung)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorRes"}}}}}}}},"components":{"schemas":{"ErrorRes":{"type":"object","properties":{"error":{"type":"string"},"chi_tiet":{}},"required":["error"],"additionalProperties":false},"StatsTinh":{"type":"object","properties":{"lop_ma":{"type":"string"},"ten_lop":{"type":"string"},"cap":{"type":"array","items":{"type":"object","properties":{"cap":{"type":"integer","minimum":0,"maximum":4},"nhan":{"type":"string"},"mau":{"type":"string"},"km2":{"type":"number"},"pct":{"type":"number"}},"required":["cap","nhan","mau","km2","pct"],"additionalProperties":false}},"km2_cao_rat_cao":{"type":"number"},"pct_cao_rat_cao":{"type":"number"},"dan_so":{"type":"number"},"dan_so_phoi_nhiem":{"type":"number"},"dat_canh_tac_nguy_co_km2":{"type":["number","null"]},"km2_tung_ngap":{"type":"number"},"nguon":{"type":"string"}},"required":["lop_ma","ten_lop","cap","km2_cao_rat_cao","pct_cao_rat_cao","dan_so","dan_so_phoi_nhiem","dat_canh_tac_nguy_co_km2","km2_tung_ngap","nguon"],"additionalProperties":false},"StatsXaRes":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"xa_ma":{"type":"string"},"ten":{"type":"string"},"gia_tri":{"type":["number","null"]},"hang":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["xa_ma","ten","gia_tri","hang"],"additionalProperties":false}},"chi_tieu":{"type":"string","enum":["km2_cao_rat_cao","ty_le_cao_rat_cao_pct","dan_so_phoi_nhiem","ty_le_tung_ngap_pct","mua_nam_tb_mm","rx5day_max_mm"]},"don_vi":{"type":"string"}},"required":["items","chi_tieu","don_vi"],"additionalProperties":false},"SuKienNgapListRes":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"ma":{"type":"string"},"ngay":{"type":"string"},"nguon":{"type":"string","enum":["sentinel1_du_an","unosat","copernicus_ems","ghi_nhan_thuc_dia","tai_len","cong_van"]},"ve_tinh":{"type":["string","null"]},"dien_tich_km2":{"type":["number","null"]},"ty_so_r":{"type":["number","null"]},"chat_luong":{"type":"string","enum":["dung_duoc","nghi_ngo","hong","chua_danh_gia"]},"lop_ma":{"type":["string","null"]},"co_che_xuat_anh":{"anyOf":[{"type":"string","enum":["phu_du","phu_mot_phan","cap_trung","phu_mot_phan_va_trung"]},{"type":"null"}]},"phu_chung_pct":{"type":["number","null"]},"ty_le_o_trung_pct":{"type":["number","null"]}},"required":["ma","ngay","nguon","ve_tinh","dien_tich_km2","ty_so_r","chat_luong","lop_ma","co_che_xuat_anh","phu_chung_pct","ty_le_o_trung_pct"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false},"HuyenCuDoiChieuRes":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"huyen_cu_ma":{"type":"string"},"ten":{"type":"string"},"thuoc_thuyet_minh":{"type":"boolean"},"xa":{"type":"array","items":{"type":"object","properties":{"ma":{"type":"string"},"ten":{"type":"string"}},"required":["ma","ten"],"additionalProperties":false}}},"required":["huyen_cu_ma","ten","thuoc_thuyet_minh","xa"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false},"XaListRes":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"ma":{"type":"string"},"ten":{"type":"string"},"loai":{"type":"string","enum":["xa","phuong"]},"huyen_cu":{"type":["string","null"]},"dien_tich_km2":{"type":"number"},"km2_cao_rat_cao":{"type":"number"},"ty_le_cao_rat_cao_pct":{"type":"number"},"dan_so":{"type":["number","null"]},"dan_so_phoi_nhiem":{"type":["number","null"]},"cap_canh_bao_hien_hanh":{"anyOf":[{"type":"integer","minimum":0,"maximum":5},{"type":"null"}]}},"required":["ma","ten","loai","huyen_cu","dien_tich_km2","km2_cao_rat_cao","ty_le_cao_rat_cao_pct","dan_so","dan_so_phoi_nhiem","cap_canh_bao_hien_hanh"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false},"XaFeatureCollection":{"type":"object","properties":{"type":{"type":"string","const":"FeatureCollection"},"features":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"Feature"},"geometry":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"Polygon"},"coordinates":{"minItems":1,"type":"array","items":{"type":"array","items":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"}],"items":false,"minItems":2,"maxItems":2}}}},"required":["type","coordinates"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"MultiPolygon"},"coordinates":{"minItems":1,"type":"array","items":{"type":"array","items":{"type":"array","items":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"}],"items":false,"minItems":2,"maxItems":2}}}}},"required":["type","coordinates"],"additionalProperties":false}]},"properties":{"type":"object","properties":{"ma":{"type":"string"},"ten":{"type":"string"},"loai":{"type":"string","enum":["xa","phuong"]},"huyen_cu":{"type":["string","null"]},"dien_tich_km2":{"type":"number"},"km2_cao_rat_cao":{"type":"number"},"ty_le_cao_rat_cao_pct":{"type":"number"},"dan_so":{"type":["number","null"]},"dan_so_phoi_nhiem":{"type":["number","null"]},"cap_canh_bao_hien_hanh":{"anyOf":[{"type":"integer","minimum":0,"maximum":5},{"type":"null"}]}},"required":["ma","ten","loai","huyen_cu","dien_tich_km2","km2_cao_rat_cao","ty_le_cao_rat_cao_pct","dan_so","dan_so_phoi_nhiem","cap_canh_bao_hien_hanh"],"additionalProperties":false}},"required":["type","geometry","properties"],"additionalProperties":false}}},"required":["type","features"],"additionalProperties":false},"XaDetailRes":{"type":"object","properties":{"xa":{"type":"object","properties":{"ma":{"type":"string"},"ten":{"type":"string"},"loai":{"type":"string","enum":["xa","phuong"]},"huyen_cu":{"type":["string","null"]},"dien_tich_km2":{"type":"number"},"km2_cao_rat_cao":{"type":"number"},"ty_le_cao_rat_cao_pct":{"type":"number"},"dan_so":{"type":["number","null"]},"dan_so_phoi_nhiem":{"type":["number","null"]},"cap_canh_bao_hien_hanh":{"anyOf":[{"type":"integer","minimum":0,"maximum":5},{"type":"null"}]},"thanh_lap_tu":{"type":["string","null"]},"huyen_cu_ds":{"type":"array","items":{"type":"string"}},"bbox":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"items":false,"minItems":4,"maxItems":4},"nguy_co":{"type":"array","items":{"type":"object","properties":{"lop_ma":{"type":"string"},"ten_lop":{"type":"string"},"cap":{"type":"array","items":{"type":"object","properties":{"cap":{"type":"integer","minimum":0,"maximum":4},"nhan":{"type":"string"},"mau":{"type":"string"},"km2":{"type":"number"},"pct":{"type":"number"}},"required":["cap","nhan","mau","km2","pct"],"additionalProperties":false}}},"required":["lop_ma","ten_lop","cap"],"additionalProperties":false}},"phoi_nhiem":{"type":"array","items":{"type":"object","properties":{"lop_ma":{"type":"string"},"dan_so_phoi_nhiem":{"type":"number"},"dat_canh_tac_nguy_co_km2":{"type":["number","null"]}},"required":["lop_ma","dan_so_phoi_nhiem","dat_canh_tac_nguy_co_km2"],"additionalProperties":false}},"ngap_lich_su":{"anyOf":[{"type":"object","properties":{"so_su_kien_ngap":{"type":"number"},"dien_tich_tung_ngap_km2":{"type":"number"},"ty_le_tung_ngap_pct":{"type":"number"}},"required":["so_su_kien_ngap","dien_tich_tung_ngap_km2","ty_le_tung_ngap_pct"],"additionalProperties":false},{"type":"null"}]},"dac_trung":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["number","null"]}},{"type":"null"}]},"canh_bao_hien_hanh":{"anyOf":[{"type":"object","properties":{"canh_bao_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"cap":{"type":"number"},"hieu_luc_den":{"type":"string"}},"required":["canh_bao_id","cap","hieu_luc_den"],"additionalProperties":false},{"type":"null"}]}},"required":["ma","ten","loai","huyen_cu","dien_tich_km2","km2_cao_rat_cao","ty_le_cao_rat_cao_pct","dan_so","dan_so_phoi_nhiem","cap_canh_bao_hien_hanh","thanh_lap_tu","huyen_cu_ds","bbox","nguy_co","phoi_nhiem","ngap_lich_su","dac_trung","canh_bao_hien_hanh"],"additionalProperties":false}},"required":["xa"],"additionalProperties":false},"KichBanListRes":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"ma":{"type":"string","enum":["nen","ssp245_giua","ssp585_giua","ssp245_cuoi","ssp585_cuoi"]},"ten":{"type":"string"},"ssp":{"type":["string","null"]},"thoi_ky":{"type":"string"},"he_so_mua":{"type":"object","properties":{"mua_nam":{"type":"number"},"rx5day":{"type":"number"},"nguon":{"type":"string"}},"required":["mua_nam","rx5day"],"additionalProperties":false},"ghi_chu_trung_thuc":{"type":"string"},"km2_cao_rat_cao":{"type":"number"},"dan_so_phoi_nhiem":{"type":"number"},"cap":{"type":"array","items":{"type":"object","properties":{"cap":{"type":"integer","minimum":0,"maximum":4},"nhan":{"type":"string"},"mau":{"type":"string"},"km2":{"type":"number"},"pct":{"type":"number"}},"required":["cap","nhan","mau","km2","pct"],"additionalProperties":false}}},"required":["ma","ten","ssp","thoi_ky","he_so_mua","ghi_chu_trung_thuc","km2_cao_rat_cao","dan_so_phoi_nhiem","cap"],"additionalProperties":false}},"phan_tach_bat_dinh":{"type":"object","properties":{"ml":{"type":"number"},"khi_hau":{"type":"number"},"kich_ban":{"type":"number"},"tuong_tac":{"type":"number"}},"required":["ml","khi_hau","kich_ban","tuong_tac"],"additionalProperties":false},"dap_ung_mua":{"type":"array","items":{"type":"object","properties":{"he_so":{"type":"number"},"mo_hinh":{"type":"string"},"km2_cao_rat_cao":{"type":"number"}},"required":["he_so","mo_hinh","km2_cao_rat_cao"],"additionalProperties":false}}},"required":["items","phan_tach_bat_dinh","dap_ung_mua"],"additionalProperties":false},"KichBanDetailRes":{"type":"object","properties":{"kich_ban":{"type":"object","properties":{"ma":{"type":"string","enum":["nen","ssp245_giua","ssp585_giua","ssp245_cuoi","ssp585_cuoi"]},"ten":{"type":"string"},"ssp":{"type":["string","null"]},"thoi_ky":{"type":"string"},"he_so_mua":{"type":"object","properties":{"mua_nam":{"type":"number"},"rx5day":{"type":"number"},"nguon":{"type":"string"}},"required":["mua_nam","rx5day"],"additionalProperties":false},"ghi_chu_trung_thuc":{"type":"string"},"km2_cao_rat_cao":{"type":"number"},"dan_so_phoi_nhiem":{"type":"number"},"cap":{"type":"array","items":{"type":"object","properties":{"cap":{"type":"integer","minimum":0,"maximum":4},"nhan":{"type":"string"},"mau":{"type":"string"},"km2":{"type":"number"},"pct":{"type":"number"}},"required":["cap","nhan","mau","km2","pct"],"additionalProperties":false}}},"required":["ma","ten","ssp","thoi_ky","he_so_mua","ghi_chu_trung_thuc","km2_cao_rat_cao","dan_so_phoi_nhiem","cap"],"additionalProperties":false},"xa":{"type":"array","items":{"type":"object","properties":{"xa_ma":{"type":"string"},"ten":{"type":"string"},"km2_nen":{"type":"number"},"km2_kich_ban":{"type":"number"},"chenh_km2":{"type":"number"}},"required":["xa_ma","ten","km2_nen","km2_kich_ban","chenh_km2"],"additionalProperties":false}}},"required":["kich_ban","xa"],"additionalProperties":false},"LayersRes":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"ma":{"type":"string"},"ten":{"type":"string"},"nhom":{"type":"string"},"loai":{"type":"string","enum":["raster","vector"]},"kieu_gia_tri":{"type":"string"},"geoserver_layer":{"type":["string","null"]},"wms_path":{"type":["string","null"]},"thu_tu":{"type":"number"},"mac_dinh_bat":{"type":"boolean"},"do_trong_suot":{"type":"number"},"chu_giai":{"type":"array","items":{"type":"object","properties":{"gia_tri":{"type":["number","string"]},"nhan":{"type":"string"},"mau":{"type":"string"}},"required":["gia_tri","nhan","mau"],"additionalProperties":false}},"nguon":{"type":"string"},"giay_phep":{"type":"string"},"ghi_nguon":{"type":"string"},"nam":{"type":["number","null"]},"nhan_trung_thuc":{"type":["string","null"]},"cho_phep_tai":{"type":"boolean"},"chi_dang_nhap":{"type":"boolean"},"styles":{"type":"array","items":{"type":"string"}}},"required":["ma","ten","nhom","loai","kieu_gia_tri","geoserver_layer","wms_path","thu_tu","mac_dinh_bat","do_trong_suot","chu_giai","nguon","giay_phep","ghi_nguon","nam","nhan_trung_thuc","cho_phep_tai","chi_dang_nhap","styles"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false},"LayerDetailRes":{"type":"object","properties":{"layer":{"type":"object","properties":{"ma":{"type":"string"},"ten":{"type":"string"},"nhom":{"type":"string"},"loai":{"type":"string","enum":["raster","vector"]},"kieu_gia_tri":{"type":"string"},"geoserver_layer":{"type":["string","null"]},"wms_path":{"type":["string","null"]},"thu_tu":{"type":"number"},"mac_dinh_bat":{"type":"boolean"},"do_trong_suot":{"type":"number"},"chu_giai":{"type":"array","items":{"type":"object","properties":{"gia_tri":{"type":["number","string"]},"nhan":{"type":"string"},"mau":{"type":"string"}},"required":["gia_tri","nhan","mau"],"additionalProperties":false}},"nguon":{"type":"string"},"giay_phep":{"type":"string"},"ghi_nguon":{"type":"string"},"nam":{"type":["number","null"]},"nhan_trung_thuc":{"type":["string","null"]},"cho_phep_tai":{"type":"boolean"},"chi_dang_nhap":{"type":"boolean"},"styles":{"type":"array","items":{"type":"string"}},"mo_ta":{"type":["string","null"]},"phien_ban":{"type":"array","items":{"type":"object","properties":{"nam":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"phien_ban":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"created_at":{"type":"string"}},"required":["nam","phien_ban","created_at"],"additionalProperties":false}}},"required":["ma","ten","nhom","loai","kieu_gia_tri","geoserver_layer","wms_path","thu_tu","mac_dinh_bat","do_trong_suot","chu_giai","nguon","giay_phep","ghi_nguon","nam","nhan_trung_thuc","cho_phep_tai","chi_dang_nhap","styles","mo_ta","phien_ban"],"additionalProperties":false}},"required":["layer"],"additionalProperties":false},"CanhBaoPublicList":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"ma":{"type":"string"},"tieu_de":{"type":"string"},"trang_thai":{"type":"string","enum":["nhap","cho_duyet","da_ban_hanh","da_huy","het_hieu_luc"]},"hieu_luc_tu":{"type":"string"},"hieu_luc_den":{"type":"string"},"ban_hanh_luc":{"type":"string"},"cap_cao_nhat":{"type":"number"},"so_xa_canh_bao":{"type":"number"},"tom_tat":{"type":["string","null"]},"noi_dung":{"type":["string","null"]},"khuyen_cao":{"type":["string","null"]},"mien_tru":{"type":"string"},"nguon_mua":{"type":"string"},"thoi_diem_du_lieu_mua":{"type":"string"},"xa":{"type":"array","items":{"type":"object","properties":{"xa_ma":{"type":"string"},"ten_xa":{"type":"string"},"cap":{"type":"integer","minimum":0,"maximum":5},"mua_24h_mm":{"type":["number","null"]},"mua_48h_mm":{"type":["number","null"]},"mua_72h_mm":{"type":["number","null"]},"nhom_nguy_co_xa":{"type":"string","enum":["thap","trung_binh","cao"]},"ly_do":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"vung_qd18":{"anyOf":[{"type":"string","enum":["trung_du_mien_nui","dong_bang_ven_bien"]},{"type":"null"}]},"so_ngay_vuot":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"xac_suat_r24_100":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"cap_lu_tram":{"anyOf":[{"type":"integer","minimum":0,"maximum":3},{"type":"null"}]}},"required":["xa_ma","ten_xa","cap","mua_24h_mm","mua_48h_mm","mua_72h_mm","nhom_nguy_co_xa","ly_do","vung_qd18","so_ngay_vuot","xac_suat_r24_100","cap_lu_tram"],"additionalProperties":false}},"cap_do_rui_ro_tinh":{"type":"integer","minimum":0,"maximum":2},"co_the_cap_cao":{"type":"boolean"},"trong_mua_lu":{"type":"boolean"}},"required":["id","ma","tieu_de","trang_thai","hieu_luc_tu","hieu_luc_den","ban_hanh_luc","cap_cao_nhat","so_xa_canh_bao","tom_tat","noi_dung","khuyen_cao","mien_tru","nguon_mua","thoi_diem_du_lieu_mua","xa","cap_do_rui_ro_tinh","co_the_cap_cao","trong_mua_lu"],"additionalProperties":false}},"trong_mua_lu":{"type":"boolean"},"cap_nhat_mua_cuoi":{"type":["string","null"]},"lien_ket_chinh_thuc":{"type":"array","items":{"type":"object","properties":{"ten":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["ten","url"],"additionalProperties":false}}},"required":["items","trong_mua_lu","cap_nhat_mua_cuoi","lien_ket_chinh_thuc"],"additionalProperties":false},"CanhBaoLichSuRes":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"ma":{"type":"string"},"tieu_de":{"type":"string"},"trang_thai":{"type":"string","enum":["nhap","cho_duyet","da_ban_hanh","da_huy","het_hieu_luc"]},"hieu_luc_tu":{"type":"string"},"hieu_luc_den":{"type":"string"},"ban_hanh_luc":{"type":"string"},"cap_cao_nhat":{"type":"number"},"so_xa_canh_bao":{"type":"number"},"tom_tat":{"type":["string","null"]},"noi_dung":{"type":["string","null"]},"khuyen_cao":{"type":["string","null"]},"mien_tru":{"type":"string"},"nguon_mua":{"type":"string"},"thoi_diem_du_lieu_mua":{"type":"string"},"cap_do_rui_ro_tinh":{"type":"integer","minimum":0,"maximum":2},"co_the_cap_cao":{"type":"boolean"},"trong_mua_lu":{"type":"boolean"}},"required":["id","ma","tieu_de","trang_thai","hieu_luc_tu","hieu_luc_den","ban_hanh_luc","cap_cao_nhat","so_xa_canh_bao","tom_tat","noi_dung","khuyen_cao","mien_tru","nguon_mua","thoi_diem_du_lieu_mua","cap_do_rui_ro_tinh","co_the_cap_cao","trong_mua_lu"],"additionalProperties":false}},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"page":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"size":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["items","total","page","size"],"additionalProperties":false},"CanhBaoPublicDetailRes":{"type":"object","properties":{"canh_bao":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"ma":{"type":"string"},"tieu_de":{"type":"string"},"trang_thai":{"type":"string","enum":["nhap","cho_duyet","da_ban_hanh","da_huy","het_hieu_luc"]},"hieu_luc_tu":{"type":"string"},"hieu_luc_den":{"type":"string"},"ban_hanh_luc":{"type":"string"},"cap_cao_nhat":{"type":"number"},"so_xa_canh_bao":{"type":"number"},"tom_tat":{"type":["string","null"]},"noi_dung":{"type":["string","null"]},"khuyen_cao":{"type":["string","null"]},"mien_tru":{"type":"string"},"nguon_mua":{"type":"string"},"thoi_diem_du_lieu_mua":{"type":"string"},"xa":{"type":"array","items":{"type":"object","properties":{"xa_ma":{"type":"string"},"ten_xa":{"type":"string"},"cap":{"type":"integer","minimum":0,"maximum":5},"mua_24h_mm":{"type":["number","null"]},"mua_48h_mm":{"type":["number","null"]},"mua_72h_mm":{"type":["number","null"]},"nhom_nguy_co_xa":{"type":"string","enum":["thap","trung_binh","cao"]},"ly_do":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"vung_qd18":{"anyOf":[{"type":"string","enum":["trung_du_mien_nui","dong_bang_ven_bien"]},{"type":"null"}]},"so_ngay_vuot":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"xac_suat_r24_100":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"cap_lu_tram":{"anyOf":[{"type":"integer","minimum":0,"maximum":3},{"type":"null"}]}},"required":["xa_ma","ten_xa","cap","mua_24h_mm","mua_48h_mm","mua_72h_mm","nhom_nguy_co_xa","ly_do","vung_qd18","so_ngay_vuot","xac_suat_r24_100","cap_lu_tram"],"additionalProperties":false}},"cap_do_rui_ro_tinh":{"type":"integer","minimum":0,"maximum":2},"co_the_cap_cao":{"type":"boolean"},"trong_mua_lu":{"type":"boolean"}},"required":["id","ma","tieu_de","trang_thai","hieu_luc_tu","hieu_luc_den","ban_hanh_luc","cap_cao_nhat","so_xa_canh_bao","tom_tat","noi_dung","khuyen_cao","mien_tru","nguon_mua","thoi_diem_du_lieu_mua","xa","cap_do_rui_ro_tinh","co_the_cap_cao","trong_mua_lu"],"additionalProperties":false}},"required":["canh_bao"],"additionalProperties":false},"IdentifyRes":{"type":"object","properties":{"vi_tri":{"type":"object","properties":{"lon":{"type":"number"},"lat":{"type":"number"},"vn2000_x_bac":{"type":"number"},"vn2000_y_dong":{"type":"number"}},"required":["lon","lat","vn2000_x_bac","vn2000_y_dong"],"additionalProperties":false},"xa":{"anyOf":[{"type":"object","properties":{"ma":{"type":"string"},"ten":{"type":"string"}},"required":["ma","ten"],"additionalProperties":false},{"type":"null"}]},"gia_tri":{"type":"array","items":{"type":"object","properties":{"lop_ma":{"type":"string"},"ten":{"type":"string"},"gia_tri":{"type":["number","null"]},"nhan":{"type":["string","null"]},"don_vi":{"type":["string","null"]}},"required":["lop_ma","ten","gia_tri","nhan","don_vi"],"additionalProperties":false}},"canh_bao":{"anyOf":[{"type":"object","properties":{"cap":{"type":"number"},"canh_bao_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["cap","canh_bao_id"],"additionalProperties":false},{"type":"null"}]}},"required":["vi_tri","xa","gia_tri","canh_bao"],"additionalProperties":false},"IdentifyReq":{"type":"object","properties":{"lon":{"type":"number","minimum":104.5,"maximum":107},"lat":{"type":"number","minimum":17.5,"maximum":19.2},"lop":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string"}}},"required":["lon","lat","lop"]},"PhanTichVungRes":{"type":"object","properties":{"dien_tich_km2":{"type":"number"},"lop_ma":{"type":"string"},"theo_cap":{"type":"array","items":{"type":"object","properties":{"cap":{"type":"integer","minimum":0,"maximum":4},"nhan":{"type":"string"},"mau":{"type":"string"},"km2":{"type":"number"},"pct":{"type":"number"}},"required":["cap","nhan","mau","km2","pct"],"additionalProperties":false}},"km2_tung_ngap":{"type":"number"},"dan_so":{"type":"number"},"dan_so_phoi_nhiem":{"type":"number"},"dat_canh_tac_km2":{"type":"number"},"dat_canh_tac_nguy_co_km2":{"type":"number"},"nguon_tinh":{"type":"string","enum":["thong_ke_tinh_san","model_svc"]},"thoi_gian_ms":{"type":"number"}},"required":["dien_tich_km2","lop_ma","theo_cap","km2_tung_ngap","dan_so","dan_so_phoi_nhiem","dat_canh_tac_km2","dat_canh_tac_nguy_co_km2","nguon_tinh","thoi_gian_ms"],"additionalProperties":false},"PhanTichVungReq":{"anyOf":[{"type":"object","properties":{"xa_ma":{"type":"string"},"lop_ma":{"type":"string"}},"required":["xa_ma"]},{"type":"object","properties":{"geometry":{"type":"object","properties":{"type":{"type":"string","const":"Polygon"},"coordinates":{"minItems":1,"type":"array","items":{"type":"array","items":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"}],"items":false,"minItems":2,"maxItems":2}}}},"required":["type","coordinates"]},"lop_ma":{"type":"string"}},"required":["geometry"]}]},"TimKiemRes":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"loai":{"type":"string","enum":["xa","dia_danh","toa_do"]},"ten":{"type":"string"},"mo_ta":{"type":"string"},"lon":{"type":"number"},"lat":{"type":"number"},"bbox":{"anyOf":[{"type":"array","prefixItems":[{"type":"number"},{"type":"number"},{"type":"number"},{"type":"number"}],"items":false,"minItems":4,"maxItems":4},{"type":"null"}]},"xa_ma":{"type":["string","null"]}},"required":["loai","ten","mo_ta","lon","lat","bbox","xa_ma"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false},"BanDoPdfListRes":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"loai":{"type":"string","enum":["tinh","huyen_cu","xa"]},"don_vi_ma":{"type":"string"},"ten":{"type":"string"},"ty_le":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"kho_giay":{"type":"string","enum":["A4","A3","A2","A1","A0"]},"kich_thuoc_byte":{"type":"number"},"tao_luc":{"type":"string"}},"required":["id","loai","don_vi_ma","ten","ty_le","kho_giay","kich_thuoc_byte","tao_luc"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false},"HoiDapRes":{"type":"object","properties":{"tra_loi":{"type":"string"},"so_lieu":{"type":"array","items":{"type":"object","properties":{"nhan":{"type":"string"},"gia_tri":{"type":["number","string"]},"don_vi":{"type":["string","null"]}},"required":["nhan","gia_tri","don_vi"],"additionalProperties":false}},"nguon":{"type":"array","items":{"type":"object","properties":{"tieu_de":{"type":"string"},"duong_dan":{"type":"string"}},"required":["tieu_de","duong_dan"],"additionalProperties":false}},"y_dinh":{"type":"string"},"hau_kiem_dat":{"type":"boolean"}},"required":["tra_loi","so_lieu","nguon","y_dinh","hau_kiem_dat"],"additionalProperties":false},"HoiDapReq":{"type":"object","properties":{"cau_hoi":{"type":"string","minLength":3,"maxLength":500}},"required":["cau_hoi"]},"HealthRes":{"type":"object","properties":{"ok":{"type":"boolean"},"db":{"type":"string","enum":["ok","loi"]}},"required":["ok","db"],"additionalProperties":false}}},"externalDocs":{"description":"Trang tài liệu API","url":"/api-docs"}}