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/validate

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": "Phường 11, Quận 10, TP.HCM",
    "valid": true,
    "current": false,
    "model": "old-3-level",
    "confidence": "exact",
    "issues": [
      {
        "code": "OUTDATED_MODEL",
        "field": "address",
        "message": "Địa chỉ theo mô hình 3 cấp (có quận/huyện), không còn dùng từ 01/07/2025."
      },
      {
        "code": "DISSOLVED_UNIT",
        "field": "ward",
        "message": "Phường 11 đã không còn từ 01/01/2025 (1278/NQ-UBTVQH15)."
      }
    ],
    "suggestion": "Phường Vườn Lài, Thành phố Hồ Chí Minh"
  },
  "meta": {
    "requestId": "req-40",
    "tookMs": 7,
    "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/validate \
  -H 'content-type: application/json' \
  -d '{"address":"Phường 11, Quận 10, TP.HCM"}'

JavaScript

const res = await fetch('https://tradiachi.com/v1/address/validate', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    "address": "Phường 11, Quận 10, TP.HCM"
  }),
});
const { data, error } = await res.json();

Python

import requests

res = requests.post('https://tradiachi.com/v1/address/validate', json={
    "address": "Phường 11, Quận 10, TP.HCM"
}, timeout=10)
print(res.json())

PHP

<?php
$ch = curl_init('https://tradiachi.com/v1/address/validate');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ['content-type: application/json'],
  CURLOPT_POSTFIELDS => json_encode([
    'address' => "Phường 11, Quận 10, TP.HCM",
  ]),
  CURLOPT_RETURNTRANSFER => true,
]);
var_dump(json_decode(curl_exec($ch), true));