Chuyển địa chỉ theo địa giới cũ sang địa giới mới

POST https://api-tools.hitechcloud.vn/api/v2/convert-address Đã chép

Cần khoá API

Tham số

detailAddress string · thân yêu cầu

districtCode string · thân yêu cầu

provinceCode string · thân yêu cầu

villageId string · thân yêu cầu

wardCode string · thân yêu cầu

Mã trả về

200 Thành công.

401 Thiếu hoặc sai khoá API. Gửi kèm header X-API-Key.

404 Không tìm thấy dữ liệu tương ứng.

429 Vượt hạn mức của khoá. Xem header Retry-After.

Ví dụ gọi

bash

curl --location --request POST 'https://api-tools.hitechcloud.vn/api/v2/convert-address' \
--header 'X-API-Key: $HITECH_API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'detailAddress=GIA_TRI' \
--data-urlencode 'districtCode=GIA_TRI' \
--data-urlencode 'provinceCode=GIA_TRI' \
--data-urlencode 'villageId=GIA_TRI' \
--data-urlencode 'wardCode=GIA_TRI'

php

$response = Http::withHeaders([
    'X-API-Key' => env('HITECH_API_KEY'),
])->post('https://api-tools.hitechcloud.vn/api/v2/convert-address', [
    'detailAddress' => 'GIA_TRI',
    'districtCode' => 'GIA_TRI',
    'provinceCode' => 'GIA_TRI',
    'villageId' => 'GIA_TRI',
    'wardCode' => 'GIA_TRI',
]);

$data = $response->json();

javascript

const body = new URLSearchParams();
body.append('detailAddress', 'GIA_TRI');
body.append('districtCode', 'GIA_TRI');
body.append('provinceCode', 'GIA_TRI');
body.append('villageId', 'GIA_TRI');
body.append('wardCode', 'GIA_TRI');

const res = await fetch('https://api-tools.hitechcloud.vn/api/v2/convert-address', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.HITECH_API_KEY,
    'Content-Type': 'application/x-www-form-urlencoded',
  },
  body,
});

const data = await res.json();

python

import os, requests

res = requests.post(
    "https://api-tools.hitechcloud.vn/api/v2/convert-address",
    headers={"X-API-Key": os.environ["HITECH_API_KEY"]},
    data={
        "detailAddress": "GIA_TRI",
        "districtCode": "GIA_TRI",
        "provinceCode": "GIA_TRI",
        "villageId": "GIA_TRI",
        "wardCode": "GIA_TRI",
    },
)
data = res.json()

Đã chép mã

Thử ngay

X-API-Key

Khoá chỉ lưu trong trình duyệt của bạn. Lấy khoá →

detailAddress thân yêu cầu

districtCode thân yêu cầu

provinceCode thân yêu cầu

villageId thân yêu cầu

wardCode thân yêu cầu

Cùng nhóm

GET Danh sách quốc gia kèm mã ISO và mã điện thoại GET Tra ngược từ mã bưu chính năm chữ số ra các xã... GET Danh sách 34 tỉnh và thành phố trực thuộc trun... GET Chi tiết một tỉnh hoặc thành phố trực thuộc tr... GET Toàn bộ xã GET Đoán tỉnh và xã/phường từ một chuỗi địa chỉ tự...