Developer Beta

API Playground

Chọn endpoint, sửa tham số, gửi yêu cầu thật tới Address API v1 và copy mã tương ứng.

RequestPOST /v1/address/parse

Body (JSON)

Cần JavaScript để gửi từ trang này; phản hồi bên cạnh là kết quả thật của ví dụ.

ResponseHTTP 200

{
  "apiVersion": "1",
  "status": "beta",
  "data": {
    "input": "12 Nguyễn Huệ, P. Bến Nghé, Q.1, TP.HCM",
    "model": "old-3-level",
    "confidence": "exact",
    "components": {
      "houseNumber": "12",
      "street": "Nguyễn Huệ",
      "ward": {
        "name": "Phường Bến Nghé",
        "code": "26740",
        "slug": "phuong-ben-nghe"
      },
      "district": {
        "name": "Quận 1",
        "code": "760",
        "slug": "quan-1"
      },
      "province": {
        "name": "Thành phố Hồ Chí Minh",
        "code": "79",
        "slug": "thanh-pho-ho-chi-minh"
      }
    },
    "current": {
      "ward": {
        "name": "Phường Sài Gòn",
        "code": "26740",
        "slug": "phuong-sai-gon"
      },
      "province": {
        "name": "Thành phố Hồ Chí Minh",
        "code": "79",
        "slug": "ho-chi-minh"
      }
    }
  },
  "meta": {
    "requestId": "req-6z",
    "tookMs": 25,
    "sources": [
      {
        "id": "gso-2025",
        "name": "Danh mục đơn vị hành chính – Tổng cục Thống kê",
        "asOf": "2025-03-01"
      },
      {
        "id": "nq-202-2025",
        "name": "Nghị quyết 202/2025/QH15 và các nghị quyết sắp xếp cấp xã năm 2025",
        "asOf": "2025-07-01"
      }
    ]
  }
}

cURL

curl -X POST https://tradiachi.com/v1/address/parse \
  -H 'content-type: application/json' \
  -d '{"address":"12 Nguyễn Huệ, P. Bến Nghé, Q.1, TP.HCM"}'

JavaScript

const res = await fetch('https://tradiachi.com/v1/address/parse', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    "address": "12 Nguyễn Huệ, P. Bến Nghé, Q.1, TP.HCM"
  }),
});
const { data, error } = await res.json();

Python

import requests

res = requests.post('https://tradiachi.com/v1/address/parse', json={
    "address": "12 Nguyễn Huệ, P. Bến Nghé, Q.1, TP.HCM"
}, timeout=10)
print(res.json())

PHP

<?php
$ch = curl_init('https://tradiachi.com/v1/address/parse');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ['content-type: application/json'],
  CURLOPT_POSTFIELDS => json_encode([
    'address' => "12 Nguyễn Huệ, P. Bến Nghé, Q.1, TP.HCM",
  ]),
  CURLOPT_RETURNTRANSFER => true,
]);
var_dump(json_decode(curl_exec($ch), true));