Tra cứu địa chỉ

Tra cứu địa chỉ

Dựa theo Nghị quyết 76/2025/UBTVQH15

Tài liệu API

API tra cứu địa chỉ hành chính sau sáp nhập theo Nghị quyết 76/2025/UBTVQH15

Tổng quan

API cung cấp các endpoint để tra cứu thông tin địa chỉ hành chính sau khi sắp xếp, sáp nhập theo Nghị quyết 76/2025/UBTVQH15.

Base URL

https://api.tracuudiachi.io.vn/api

API Version

v1

Content-Type

application/json

Xác thực

API hiện tại không yêu cầu xác thực bắt buộc. Tuy nhiên, bạn có thể cung cấp API Key qua header để sử dụng các tính năng nâng cao hoặc tăng rate limit.

Header (Optional)

X-API-Key: <your-api-key>

Hệ thống cũ vs Hệ thống mới

Trước sáp nhập

  • 3 cấp: Tỉnh → Quận/Huyện → Xã/Phường
  • Endpoint: /v1/provinces
  • Endpoint: /v1/convert-address

Sau sáp nhập

  • 2 cấp: Tỉnh → Xã/Phường (không có Quận/Huyện)
  • Endpoint: /v1/new-provinces
  • Endpoint: /v1/search-new-address

Lưu ý quan trọng

  • API đang trong giai đoạn phát triển. Các endpoint có thể thay đổi.
  • Dữ liệu phục vụ mục đích tra cứu, tham khảo theo Nghị quyết 76/2025/UBTVQH15.
  • Không có giới hạn về số lượng request, tuy nhiên vui lòng sử dụng hợp lý.
  • Response format có thể khác nhau giữa các endpoint (array trực tiếp hoặc wrapped object).

Mã lỗi HTTP

Status CodeMô tả
200Thành công
400Request không hợp lệ
404Không tìm thấy dữ liệu
500Lỗi server