API mở – Xâm nhập mặn Sóc Trăng Phiên bản 1.0 · Cổng thông tin đấu nối dữ liệu quan trắc & dự báo

Giới thiệu

API mở cung cấp dữ liệu quan trắc tài nguyên nước và kết quả dự báo xâm nhập mặn trên hệ thống sông, kênh chính tỉnh Sóc Trăng cho các cơ quan, đơn vị liên quan (Sở TN&MT, Sở NN&PTNT, các bên phối hợp) tự truy cập và lấy dữ liệu.

• Địa chỉ gốc (base URL): http://dubaoxnmst.hcmunre.edu.vn/api/v1
• Chỉ hỗ trợ phương thức GET, trả về JSON (một số endpoint hỗ trợ thêm CSV).
• Mọi request đều được ghi nhật ký phục vụ quản lý & giám sát kết nối.

GET http://dubaoxnmst.hcmunre.edu.vn/api/v1/         → thông tin dịch vụ + danh sách endpoint (không cần key)

Xác thực

Mỗi cơ quan/đối tác được cấp một API key riêng (quản trị viên tạo tại trang Quản trị API). Gửi key theo một trong hai cách:

curl -H "X-API-Key: <API_KEY>" "http://dubaoxnmst.hcmunre.edu.vn/api/v1/stations"

# hoặc qua query string
curl "http://dubaoxnmst.hcmunre.edu.vn/api/v1/stations?api_key=<API_KEY>"

Mỗi key được gán một hoặc nhiều scope (phạm vi truy cập):

Hạn mức (rate limit)

Mỗi key có hạn mức số request/ngày (mặc định 5000, quản trị viên điều chỉnh được). Phản hồi kèm header:

• X-RateLimit-Limit – hạn mức/ngày
• X-RateLimit-Remaining – số request còn lại trong ngày
• Retry-After – (khi bị chặn) số giây tới 00:00

Vượt hạn mức → HTTP 429 với mã lỗi rate_limited.

Định dạng phản hồi

{
  "success": true,
  "api_version": "1.0",
  "generated_at": "2026-09-06T20:00:00+07:00",
  "request": { "endpoint": "observations", "params": { ... } },
  "meta":    { "count": 100, "total": 5000, "limit": 1000, "offset": 0, "unit": { ... } },
  "data":    [ ... ]
}

Khi lỗi:

{
  "success": false,
  "api_version": "1.0",
  "error": { "code": "rate_limited", "message": "Đã vượt hạn mức ..." }
}

Mã lỗi & HTTP status

Endpoint

curl -H "X-API-Key: demo_public_readonly_key_2026" "http://dubaoxnmst.hcmunre.edu.vn/api/v1/stations/NGA_NAM"

curl -H "X-API-Key: demo_public_readonly_key_2026" \
  "http://dubaoxnmst.hcmunre.edu.vn/api/v1/observations?station=NGA_NAM,SOC_TRANG¶m=salinity&from=2026-08-01&to=2026-09-01&limit=500"

# Xuất CSV
curl -H "X-API-Key: demo_public_readonly_key_2026" \
  "http://dubaoxnmst.hcmunre.edu.vn/api/v1/observations?station=DAI_NGAI¶m=all&format=csv" -o dai_ngai.csv

curl -H "X-API-Key: demo_public_readonly_key_2026" "http://dubaoxnmst.hcmunre.edu.vn/api/v1/forecast?station=NGA_NAM"

curl -H "X-API-Key: demo_public_readonly_key_2026" "http://dubaoxnmst.hcmunre.edu.vn/api/v1/communes?day=3"

curl -H "X-API-Key: demo_public_readonly_key_2026" "http://dubaoxnmst.hcmunre.edu.vn/api/v1/statistics"

Phân cấp độ mặn (dùng chung mọi endpoint)

Ví dụ tích hợp

Python

import requests

BASE = "http://dubaoxnmst.hcmunre.edu.vn/api/v1"
KEY  = "demo_public_readonly_key_2026"

r = requests.get(f"{BASE}/observations",
    params={"station": "NGA_NAM,SOC_TRANG", "param": "salinity", "from": "2026-08-01"},
    headers={"X-API-Key": KEY}, timeout=30)
r.raise_for_status()
data = r.json()
print(data["meta"]["total"], "dòng")
for row in data["data"][:5]:
    print(row["thoi_gian"], row["ma_tram"], row["value"], "‰")

JavaScript (fetch)

const res = await fetch(
  "http://dubaoxnmst.hcmunre.edu.vn/api/v1/communes?day=2",
  { headers: { "X-API-Key": "demo_public_readonly_key_2026" } }
);
const { data } = await res.json();
data.forEach(c => console.log(c.name, c.salinity, c.level_label));

Cổng thông tin Xâm nhập mặn tỉnh Sóc Trăng · API v1.0 · Liên hệ quản trị hệ thống để được cấp API key.