Danh mục tỉnh / huyện / xã theo cấu hình địa bàn của hãng, để form trên website gửi đúng mã provinceId, districtId, wardId. Nên lưu đệm trên website (ít thay đổi).
Thao tác và endpoint
| Thao tác | Endpoint |
|---|---|
| Tra cứu | GET /warranty/areas |
Tham số (query)
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
level | string | province (mặc định) · district (chỉ địa bàn cũ) · ward | |
parentId | string | Khi level ≠ province | Địa bàn mới: mã tỉnh. Địa bàn cũ: mã tỉnh khi lấy huyện, mã huyện khi lấy xã |
Trường dữ liệu trả về (data)
| Trường | Kiểu | Mô tả |
|---|---|---|
level | string | Cấp đã lấy |
newAreas | boolean | true = địa bàn mới 2 cấp (tỉnh → xã), false = 3 cấp (tỉnh → huyện → xã) |
records[].id | string | Mã — gửi vào provinceId / districtId / wardId |
records[].name | string | Tên hiển thị |
Ví dụ
GET /open/api/v1/warranty/areas?level=ward&parentId=01
{
"status": 200,
"success": true,
"code": "OK",
"message": "",
"data": {
"level": "ward",
"newAreas": true,
"records": [
{ "id": "00004", "name": "Phường Ba Đình" }
]
}
}