API cho nhà phát triển

Tích hợp chuyển đổi địa chỉ vào hệ thống của bạn (vận chuyển, TMĐT, ERP...). API miễn phí, không cần đăng ký.

Cách sử dụng API

Base URL: https://chuyentendonvihanhchinh.com

Gọi API bằng cách thêm endpoint vào sau base URL. Ví dụ:

cURL:
curl "https://chuyentendonvihanhchinh.com/api/convert?text=phuong+cam+pha,+quang+ninh&direction=new_to_old"JavaScript:
const res = await fetch("https://chuyentendonvihanhchinh.com/api/convert?text=...&direction=new_to_old");Python:
requests.get("https://chuyentendonvihanhchinh.com/api/convert", params={"text": "...", "direction": "new_to_old"})

GET

/api/convert?text=...&direction=new_to_old

Chuyển đổi địa chỉ. direction: new_to_old hoặc old_to_new

GET

/api/lookup?code=06793

Tra cứu theo mã xã — trả về thông tin cả 2 hệ

GET

/api/search?q=Cẩm+Phả

Tìm kiếm fuzzy trong cả 2 hệ

GET

/api/provinces?system=new

Danh sách tỉnh. system: new (34 tỉnh), old (63 tỉnh), both

Ví dụ response

{
  "input": "phường Cẩm Phả, Quảng Ninh",
  "direction": "new_to_old",
  "result": {
    "commune_code": "06793",
    "commune": "Phường Cẩm Trung",
    "district": "Thành phố Cẩm Phả",
    "province": "Tỉnh Quảng Ninh"
  },
  "original": {
    "commune": "Phường Cẩm Phả",
    "province": "Tỉnh Quảng Ninh"
  }
}

GitHub Tải tài liệu API (.md)

Về cải cách địa chỉ hành chính 2025

Từ ngày 01/07/2025, Việt Nam chính thức thực hiện cải cách hành chính, sáp nhập từ 63 tỉnh/thành xuống 34 tỉnh/thành, đồng thời chuyển từ hệ thống 3 cấp (Tỉnh → Huyện → Xã) sang hệ thống 2 cấp (Tỉnh → Xã/Phường).

Tuy nhiên, hầu hết các hệ thống vận chuyển và thương mại điện tử (GHTK, GHN, Shopee, TikTok Shop, SuperAI...) vẫn sử dụng hệ 3 cấp cũ. Điều này gây ra vấn đề khi khách hàng gửi địa chỉ theo hệ mới nhưng hệ thống yêu cầu địa chỉ cũ.

Công cụ này giúp chuyển đổi tự động giữa 2 hệ thống, hỗ trợ cả giao diện web lẫn API để tích hợp vào phần mềm quản lý bán hàng, hệ thống tạo đơn vận chuyển và các ứng dụng TMĐT.