1. API 概述與接入說明
本站提供免費的高性能全球區號與郵政編碼查詢 API，旨在幫助軟體測試人員、開發人員及QA工程師快速集成區號匹配、國家代碼檢索、電話撥號格式規範檢查和郵政編碼校驗等功能。
所有接口返回標準的 application/json 格式，支持跨域請求（CORS），並為全球節點提供高速緩存代理。
2. 獲取支持的國家與地區列表
獲取系統中已收錄的所有國家和地區的基本元數據，包含雙位國家代碼、國家英文名、中文名和所屬數據文件夾名稱。
GET https://api.xmzxw.com/v1/countries
返回示例：
[
{
"code": "CN",
"name": "中國",
"englishName": "China",
"flag": "🇨🇳",
"folder": "cn-zip"
},
{
"code": "US",
"name": "美國",
"englishName": "United States",
"flag": "🇺🇸",
"folder": "us-zip"
}
]
3. 獲取省份/州資訊介面
根據指定的國家代碼（country_code），檢索該國下轄的所有省份或州的目錄信息。
GET https://api.xmzxw.com/v1/states?country=US
返回示例：
{
"country_code": "US",
"states": [
{ "slug": "california", "name": "California", "translatedName": "加利福尼亞" },
{ "slug": "new-york", "name": "New York", "translatedName": "紐約" }
]
}
4. 城市與郵編區號規則查詢介面
根據國家、省份/州、城市查詢詳情，包括該城市分配的所有真實電話撥號區號前綴、號碼位數規則以及郵政編碼。
GET https://api.xmzxw.com/v1/city?country=CN&state=guangdong&city=shenzhen
返回示例：
{
"city": "Shenzhen",
"translatedName": "深圳",
"state": "Guangdong",
"country": "CN",
"phoneRules": {
"countryPrefix": "+86",
"areaCodes": ["0755"],
"length": 8
},
"zips": [
{ "code": "518000", "district": "Futian District (福田區)" },
{ "code": "518052", "district": "Nanshan District (南山區)" }
]
}