Tài liệu API

Hướng dẫn sử dụng API chi tiết và ví dụ code

API 1: Chuyển đổi địa chỉ
Endpoint
POST /api/convert-batch
Hỗ trợ tối đa 1000 địa chỉ/request

Request Body

{
  "addresses": [
    "470 Đ. Trần Đại Nghĩa, Hoà Hải, Ngũ Hành Sơn, Đà Nẵng",
    "54 Nguyễn Lương Bằng, Hoà Khánh Bắc, Liên Chiểu, Đà Nẵng"
  ],
  "key": "your_api_key_here"
}

Response

{
  "success": true,
  "data": {
    "total": 2,
    "successful": 2,
    "failed": 0,
    "results": [
      {
        "original": "470 Đ. Trần Đại Nghĩa, Hoà Hải, Ngũ Hành Sơn, Đà Nẵng",
        "converted": "470 Đ. Trần Đại Nghĩa, Phường Hòa Hải, Quận Ngũ Hành Sơn, Thành phố Đà Nẵng",
        "notSure": false,
        "success": true,
        "premium_exchange": true
      },
      {
        "original": "54 Nguyễn Lương Bằng, Hoà Khánh Bắc, Liên Chiểu, Đà Nẵng",
        "converted": "54 Nguyễn Lương Bằng, Phường Hòa Khánh Bắc, Quận Liên Chiểu, Thành phố Đà Nẵng",
        "notSure": false,
        "success": true,
        "premium_exchange": false
      }
    ],
    "totalCost": 150,
    "remainingBalance": 99850
  }
}
API 2: Chuyển đổi tọa độ
Endpoint
POST /api/convert-coordinate
Chuyển đổi tọa độ thành thông tin phường/xã

Request Body

{
  "coordinates": [
    { "longitude": 108.2022, "latitude": 16.0544 },
    { "longitude": 105.8342, "latitude": 21.0278 }
  ],
  "key": "your_api_key_here"
}

Response

{
  "success": true,
  "data": [
    {
      "success": true,
      "coordinate": [108.2022, 16.0544],
      "wardInfo": {
        "newWardName": "Phường Hải Châu I",
        "provinceName": "Thành phố Đà Nẵng",
        "wardCode": "20200"
      }
    },
    {
      "success": true,
      "coordinate": [105.8342, 21.0278],
      "wardInfo": {
        "newWardName": "Phường Hoàn Kiếm",
        "provinceName": "Thành phố Hà Nội",
        "wardCode": "00001"
      }
    }
  ],
  "rateLimitInfo": {
    "remaining": Infinity,
    "dailyLimit": Infinity,
    "resetTime": "2025-07-22T09:51:28.977Z"
  }
}
Ví dụ chỉ mang tính minh hoạ. Endpoint thật có thể khác và yêu cầu API key hợp lệ.