API Demo - Dữ liệu địa hành chính

Demo 3 API chính để truy xuất dữ liệu tỉnh/thành phố và phường/xã với giao diện hiện đại

API 1: GET /api/administrative/provinces

Lấy danh sách tất cả tỉnh/thành phố trong hệ thống

Tài liệu API

Hướng dẫn chi tiết cách sử dụng các API endpoint

1GET /api/administrative/provinces

Mô tả: Lấy danh sách tất cả tỉnh/thành phố
Response Format:
{
  "success": true,
  "count": 5,
  "data": [
    {
      "id": 1,
      "name": "Hà Nội",
      "created_at": "2024-01-01T00:00:00.000Z",
      "updated_at": "2024-01-01T00:00:00.000Z"
    }
  ]
}

2GET /api/administrative/wards-by-province/[provinceId]

Mô tả: Lấy tất cả phường/xã theo ID tỉnh
Params: provinceId (number)
Response Format:
{
  "success": true,
  "province": {
    "id": 1,
    "name": "Hà Nội"
  },
  "count": 45,
  "data": [
    {
      "id": 1,
      "name": "Phường Hoàn Kiếm",
      "mergedFrom": ["Phường Hàng Bạc", "Hàng Bồ"]
    }
  ]
}

3GET /api/administrative

Mô tả: Lấy tất cả dữ liệu (tỉnh + phường)
Response Format:
{
  "success": true,
  "summary": {
    "totalProvinces": 5,
    "totalWards": 150
  },
  "data": [
    {
      "id": 1,
      "name": "Hà Nội",
      "wards": [...]
    }
  ]
}