API mở dữ liệu

Kiểm tra tình trạng hoạt động của dịch vụ và kết nối cơ sở dữ liệu (liveness/health check).

Ví dụ yêu cầu

curl -H "X-API-Key: <khóa>" \
  https://dev.nuocnongthonangiang.vn/api/v1/health

Ví dụ phản hồi (200)

{
  "status": "healthy",
  "timestamp": "2026-06-09T08:00:00+07:00",
  "version": "1.0.0",
  "service": "Cong thong tin dien tu - Trung tam Nuoc sach va Ve sinh moi truong Nong thon An Giang",
  "services": {
    "database": "healthy",
    "cache": "healthy",
    "storage": "healthy"
  }
}

Khi cơ sở dữ liệu không kết nối được: "status": "degraded", "services.database": "error", mã HTTP 503.

Thống kê tin bài đã xuất bản: tổng số, phân theo chuyên mục và theo năm.

Tham số truy vấn (tùy chọn)

Tham số	Mô tả
category_id	Lọc theo mã chuyên mục (số nguyên).
from_date	Ngày bắt đầu, định dạng YYYY-MM-DD.
to_date	Ngày kết thúc, định dạng YYYY-MM-DD.

Ví dụ yêu cầu

curl -H "X-API-Key: <khóa>" \
  "https://dev.nuocnongthonangiang.vn/api/v1/statistics/posts?from_date=2026-01-01&to_date=2026-12-31"

Ví dụ phản hồi (200)

{
  "status": "success",
  "data": {
    "total_posts": 145,
    "by_category": [
      { "category_id": "56", "category_name": "Tin hoạt động NS & VSMT", "count": 30 },
      { "category_id": "23", "category_name": "Lịch cúp nước", "count": 15 }
    ],
    "by_year": [
      { "year": 2026, "count": 11 },
      { "year": 2025, "count": 16 }
    ],
    "time_range": { "from": "2026-01-01", "to": "2026-12-31" }
  },
  "timestamp": "2026-06-09T08:00:00+07:00"
}

Trường	Ý nghĩa
data.total_posts	Tổng số tin bài đang xuất bản (theo bộ lọc).
data.by_category	Số tin theo chuyên mục (category_id, category_name, count).
data.by_year	Số tin theo năm xuất bản.
data.time_range	Khoảng thời gian áp dụng bộ lọc (null nếu không lọc).

Dữ liệu đặc tả (metadata) Dublin Core của một tin bài theo mã {id} (định dạng Phụ lục II – Thông tư BKHCN).

Tham số đường dẫn

Tham số	Kiểu	Mô tả
id	số nguyên	Mã tin bài (New_ID). Bắt buộc, > 0.

Ví dụ yêu cầu

curl -H "X-API-Key: <khóa>" \
  https://dev.nuocnongthonangiang.vn/api/v1/metadata/12594

Ví dụ phản hồi (200)

{
  "status": "success",
  "data": {
    "identifier": "https://dev.nuocnongthonangiang.vn/tin-tuc/...-12594-5",
    "title": "Tiêu đề tin bài",
    "creator": "Trung tâm Nước sạch và Vệ sinh môi trường Nông thôn An Giang",
    "publisher": "Trung tâm Nước sạch và Vệ sinh môi trường Nông thôn An Giang",
    "date": { "created": "2026-04-17", "issued": "2026-04-17", "modified": "2026-04-17" },
    "description": "Tóm tắt nội dung…",
    "language": "vie",
    "subject": ["Tên chuyên mục"],
    "type": "NewsArticle",
    "format": "text/html",
    "coverage": "An Giang, Việt Nam",
    "source": "https://dev.nuocnongthonangiang.vn/tin-tuc/...-12594-5",
    "url": "https://dev.nuocnongthonangiang.vn/tin-tuc/...-12594-5"
  },
  "timestamp": "2026-06-09T08:00:00+07:00"
}

Không tìm thấy tin (sai mã hoặc tin đã ẩn): mã 404 Not Found.