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 (南山区)" }
]
}