10. API địa chỉ đặc biệt

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

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

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

<?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"
  ]
}