API Hành Chính Việt Nam

Cung cấp dữ liệu địa giới hành chính 2 cấp, bao gồm lịch sử sáp nhập và số liệu kinh tế - xã hội.

Base URL: https://dvhc.securitysmarthome.online/api

🔐 Xác thực & Giới hạn

API hiện đang ở chế độ Public (không cần Key). Tuy nhiên, chúng tôi áp dụng Rate Limiting để bảo vệ hệ thống.

Endpoint	Giới hạn (Rate Limit)
`/search`	120 req/min
`/stats`	60 req/min
`/province`	60 req/min

🔍 Tìm kiếm địa danh

Hỗ trợ tìm kiếm thông minh: Tỉnh, Huyện (cũ), Xã (mới/cũ). Tự động phân tích từ khóa.

GET /search

Tham số (Query Params)

Tên	Kiểu	Bắt buộc	Mô tả
`query`	string	Có	Từ khóa tìm kiếm (VD: "Tân Thanh, Bắc Giang")

Ví dụ Request (JavaScript)

fetch('https://dvhc.securitysmarthome.online/api/search?query=Bắc Giang')
  .then(response => response.json())
  .then(data => console.log(data));

Ví dụ Response (JSON)

{
  "provinces": [],
  "wards": [],
  "old_wards": [
    {
      "old_ward_name": "Xã Tiên Lục",
      "old_district_name": "Huyện Lạng Giang",
      "old_province_name": "Tỉnh Bắc Giang",
      "new_ward_name": "Xã Mỹ Thái",
      "province_name": "Bắc Ninh",
      "merger_details": "Sáp nhập theo NQ..."
    }
  ]
}

📊 Thống kê hệ thống

GET /stats

Lấy tổng số lượng đơn vị hành chính hiện có và đã sáp nhập.

{
  "numProvinces": 63,
  "numWards": 10599,
  "numOldUnits": 540
}