10. API lấ́y danh sách địa chỉ cấp 4
API lấy danh sách các địa chỉ cấp 4 trong 1 đường/phường/xã - Với 1 số địa chỉ, đây là thông tin bắt buộc cần truyền lên ở API đăng đơn
Endpoint
GET /services/address/getAddressLevel4
Headers
- Token:
{API_TOKEN}
- X-Client-Source:
{PARTNER_CODE}
- Content-Type:
application/json
Sample Request
- HTTP
- CURL
- PHP
GET /services/address/getAddressLevel4?province=h%C3%A0%20n%E1%BB%99i&district=ba%20%C4%91%C3%ACnh&ward_street=%C4%91%E1%BB%99i%20c%E1%BA%A5n&address=20 HTTP/1.1
Token: {API_TOKEN}
X-Client-Source: {PARTNER_CODE}
curl -X GET -H "Token: {API_TOKEN}"\
-H "X-Client-Source: {PARTNER_CODE}"\
"{OPEN_API}/services/address/getAddressLevel4?province=h%C3%A0%20n%E1%BB%99i&district=ba%20%C4%91%C3%ACnh&ward_street=%C4%91%E1%BB%99i%20c%E1%BA%A5n&address=20"
<?php
$data = array(
"province" => "Hà nội",
"district" => "Quận Ba Đình",
"ward_street" => "Đội Cấn",
"address" => "",
);
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://services.giaohangtietkiem.vn/services/address/getAddressLevel4?" . http_build_query($data),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_HTTPHEADER => array(
"Token: APITokenSample-ca441e70288cB0515F310742",
),
));
$response = curl_exec($curl);
curl_close($curl);
echo 'Response: ' . $response;
?>
Parameters
Tham số | Bắt buộc | Mô tả |
---|---|---|
address | no | String - Địa chỉ chi tiết cần lấy danh sách địa chỉ cấp 4, ví dụ: đường Đội Cấn, Ba Đình, Hà Nội |
province | yes | String - Tên tỉnh/thành phố cần lấy danh sách địa chỉ cấp 4 |
district | yes | String - Tên quận/huyện cần lấy danh sách địa chỉ cấp 4 |
ward_street | yes | String - Tên đường/phường cần lấy danh sách địa chỉ cấp 4 |
warning
Lưu ý: Trong trường hợp address
có giá trị hợp lệ, thông tin tỉnh thành, quận huyện,... của điểm lấy sẽ được lấy theo mã địa chỉ này, các trường province
, district
, ward_street
không bắt buộc phải gửi lên
Response
{
"success": true,
"data": [
"IIG - 75 Giang Văn Minh",
"Vinapaco Building - 142 Đội Cấn",
"THCS Thống Nhất",
"Ngõ 47 Đội Cấn",
"Ngõ 46 Đội Cấn"
]
}