Mã bưu chính thế giới API

Tra mã bưu chính của 124 nước (địa danh, bang, hạt, toạ độ), tìm mã theo tên địa danh hoặc gần một toạ độ, kiểm tra định dạng mã của 180 nước.

Tham số

Ví dụ

curl "https://apibox.io.vn/v1/world-postcodes?country=GB&postcode=sw1a1aa" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/world-postcodes?country=GB&postcode=sw1a1aa', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://apibox.io.vn/v1/world-postcodes?country=GB&postcode=sw1a1aa",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/world-postcodes?country=GB&postcode=sw1a1aa');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Kết quả trả về

{
  "country": "GB",
  "postcode": "SW1A 1AA",
  "found": true,
  "format": {
    "checked": true,
    "valid": true,
    "pattern": "GIR ?0AA|(?:(?:AB|AL|B|…|ZE)(?:\\d[\\dA-Z]? ?\\d[ABD-HJLN-UW-Z]{2}))|BFPO ?\\d{1,4}",
    "examples": [
      "EC1Y 8SY",
      "GIR 0AA",
      "M2 5BQ",
      "…"
    ]
  },
  "count": 1,
  "places": [
    {
      "postcode": "SW1A 1AA",
      "place": "London",
      "admin1": "England",
      "admin1_code": "ENG",
      "admin2": "Greater London",
      "admin2_code": "GLA",
      "admin3": "City of Westminster",
      "admin3_code": "E09000033",
      "lat": 51.501,
      "lon": -0.1416,
      "accuracy": 6
    }
  ],
  "accuracy_note": "accuracy: 1 = estimated, 4 = from a GeoNames place, 6 = centroid of addresses or shape (null = unknown)",
  "data_version": "20261111",
  "attribution": [
    "Postal code data © GeoNames (geonames.org), CC BY 4.0. GB: contains Royal Mail data © Royal Mail copyright and database right; contains OS data © Crown copyright and database right (Open Government Licence v3.0).",
    "Postal code formats: Google libaddressinput address metadata, CC BY 4.0"
  ]
}

Ứng dụng

• Kiểm tra và gợi ý mã bưu chính ở trang thanh toán quốc tế
• Tự điền thành phố, bang từ mã ZIP
• Tìm mã bưu chính gần một vị trí GPS nhất
• Rà soát danh sách địa chỉ xuất khẩu có mã đúng định dạng trước khi gửi hàng

Hỏi đáp

API liên quan