{
"countryCode": "US",
"postalCode": "90210",
"found": true,
"partialMatch": false,
"count": 1,
"places": [
{
"countryCode": "US",
"postalCode": "90210",
"place": "Beverly Hills",
"region": "California",
"province": "Los Angeles",
"community": null,
"latitude": 34.0901,
"longitude": -118.4065,
"accuracy": "place"
}
],
"attribution": "Postal code data © GeoNames (https://www.geonames.org), CC BY 4.0."
}
curl --location --request GET 'https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35344/look+up+a+postal+code&country=Required&/=Required&code=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"from": {
"countryCode": "ES",
"postalCode": "37007",
"place": "Salamanca",
"region": "Castilla - Leon",
"province": "Salamanca",
"community": "Salamanca",
"latitude": 40.9688,
"longitude": -5.6716,
"accuracy": "place"
},
"to": {
"countryCode": "ES",
"postalCode": "28013",
"place": "Madrid",
"region": "Madrid",
"province": "Madrid",
"community": "Madrid",
"latitude": 40.4187,
"longitude": -3.7076,
"accuracy": "place"
},
"distanceKm": 176.5,
"distanceMiles": 109.7,
"note": "Straight-line (great-circle) distance between postal code centroids.",
"attribution": "Postal code data © GeoNames (https://www.geonames.org), CC BY 4.0."
}
curl --location --request GET 'https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35345/distance+between+postal+codes?from=ES:37007&to=ES:28013' --header 'Authorization: Bearer YOUR_API_KEY'
{
"countryCode": "DE",
"postalCode": "10115",
"valid": true,
"places": 1
}
curl --location --request GET 'https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35346/validate+a+postal+code?country=DE&code=10115' --header 'Authorization: Bearer YOUR_API_KEY'
{
"count": 121,
"countries": [
{
"countryCode": "AD",
"postalCodes": 7
},
{
"countryCode": "AE",
"postalCodes": 178171
},
{
"countryCode": "AI",
"postalCodes": 1
},
{
"countryCode": "AL",
"postalCodes": 494
},
{
"countryCode": "AR",
"postalCodes": 20260
},
{
"countryCode": "AS",
"postalCodes": 1
},
{
"countryCode": "AT",
"postalCodes": 19225
},
{
"countryCode": "AU",
"postalCodes": 18521
},
{
"countryCode": "AX",
"postalCodes": 37
},
{
"countryCode": "AZ",
"postalCodes": 1186
},
{
"countryCode": "BD",
"postalCodes": 1349
},
{
"countryCode": "BE",
"postalCodes": 2781
},
{
"countryCode": "BG",
"postalCodes": 5304
},
{
"countryCode": "BM",
"postalCodes": 112
},
{
"countryCode": "BR",
"postalCodes": 5525
},
{
"countryCode": "BY",
"postalCodes": 3133
},
{
"countryCode": "CA",
"postalCodes": 1657
},
{
"countryCode": "CC",
"postalCodes": 1
},
{
"countryCode": "CH",
"postalCodes": 4520
},
{
"countryCode": "CL",
"postalCodes": 346
},
{
"countryCode": "CN",
"postalCodes": 2352
},
{
"countryCode": "CO",
"postalCodes": 3681
},
{
"countryCode": "CR",
"postalCodes": 473
},
{
"countryCode": "CX",
"postalCodes": 1
},
{
"countryCode": "CY",
"postalCodes": 1127
},
{
"countryCode": "CZ",
"postalCodes": 15507
},
{
"countryCode": "DE",
"postalCodes": 23300
},
{
"countryCode": "DK",
"postalCodes": 1159
},
{
"countryCode": "DO",
"postalCodes": 544
},
{
"countryCode": "DZ",
"postalCodes": 15951
},
{
"countryCode": "EC",
"postalCodes": 1225
},
{
"countryCode": "EE",
"postalCodes": 5398
},
{
"countryCode": "ES",
"postalCodes": 37867
},
{
"countryCode": "FI",
"postalCodes": 3576
},
{
"countryCode": "FK",
"postalCodes": 1
},
{
"countryCode": "FM",
"postalCodes": 4
},
{
"countryCode": "FO",
"postalCodes": 130
},
{
"countryCode": "FR",
"postalCodes": 51611
},
{
"countryCode": "GB",
"postalCodes": 27450
},
{
"countryCode": "GF",
"postalCodes": 77
},
{
"countryCode": "GG",
"postalCodes": 14
},
{
"countryCode": "GI",
"postalCodes": 1
},
{
"countryCode": "GL",
"postalCodes": 33
},
{
"countryCode": "GP",
"postalCodes": 105
},
{
"countryCode": "GS",
"postalCodes": 1
},
{
"countryCode": "GT",
"postalCodes": 548
},
{
"countryCode": "GU",
"postalCodes": 21
},
{
"countryCode": "HK",
"postalCodes": 1
},
{
"countryCode": "HM",
"postalCodes": 1
},
{
"countryCode": "HN",
"postalCodes": 38
},
{
"countryCode": "HR",
"postalCodes": 6774
},
{
"countryCode": "HT",
"postalCodes": 236
},
{
"countryCode": "HU",
"postalCodes": 3571
},
{
"countryCode": "ID",
"postalCodes": 81058
},
{
"countryCode": "IE",
"postalCodes": 139
},
{
"countryCode": "IM",
"postalCodes": 87
},
{
"countryCode": "IN",
"postalCodes": 155570
},
{
"countryCode": "IO",
"postalCodes": 1
},
{
"countryCode": "IS",
"postalCodes": 195
},
{
"countryCode": "IT",
"postalCodes": 18415
},
{
"countryCode": "JE",
"postalCodes": 5
},
{
"countryCode": "JP",
"postalCodes": 146883
},
{
"countryCode": "KE",
"postalCodes": 890
},
{
"countryCode": "KR",
"postalCodes": 35583
},
{
"countryCode": "LI",
"postalCodes": 13
},
{
"countryCode": "LK",
"postalCodes": 1837
},
{
"countryCode": "LT",
"postalCodes": 21870
},
{
"countryCode": "LU",
"postalCodes": 4519
},
{
"countryCode": "LV",
"postalCodes": 6101
},
{
"countryCode": "MA",
"postalCodes": 1325
},
{
"countryCode": "MC",
"postalCodes": 29
},
{
"countryCode": "MD",
"postalCodes": 1753
},
{
"countryCode": "MH",
"postalCodes": 2
},
{
"countryCode": "MK",
"postalCodes": 220
},
{
"countryCode": "MO",
"postalCodes": 1
},
{
"countryCode": "MP",
"postalCodes": 3
},
{
"countryCode": "MQ",
"postalCodes": 100
},
{
"countryCode": "MT",
"postalCodes": 73
},
{
"countryCode": "MW",
"postalCodes": 491
},
{
"countryCode": "MX",
"postalCodes": 144655
},
{
"countryCode": "MY",
"postalCodes": 2818
},
{
"countryCode": "NC",
"postalCodes": 52
},
{
"countryCode": "NF",
"postalCodes": 1
},
{
"countryCode": "NL",
"postalCodes": 4334
},
{
"countryCode": "NO",
"postalCodes": 5132
},
{
"countryCode": "NR",
"postalCodes": 1
},
{
"countryCode": "NU",
"postalCodes": 1
},
{
"countryCode": "NZ",
"postalCodes": 1738
},
{
"countryCode": "PA",
"postalCodes": 729
},
{
"countryCode": "PE",
"postalCodes": 96943
},
{
"countryCode": "PF",
"postalCodes": 207
},
{
"countryCode": "PH",
"postalCodes": 2317
},
{
"countryCode": "PK",
"postalCodes": 2563
},
{
"countryCode": "PL",
"postalCodes": 72899
},
{
"countryCode": "PM",
"postalCodes": 2
},
{
"countryCode": "PN",
"postalCodes": 1
},
{
"countryCode": "PR",
"postalCodes": 177
},
{
"countryCode": "PT",
"postalCodes": 206942
},
{
"countryCode": "PW",
"postalCodes": 1
},
{
"countryCode": "RE",
"postalCodes": 152
},
{
"countryCode": "RO",
"postalCodes": 37915
},
{
"countryCode": "RS",
"postalCodes": 1155
},
{
"countryCode": "RU",
"postalCodes": 43538
},
{
"countryCode": "SE",
"postalCodes": 18887
},
{
"countryCode": "SG",
"postalCodes": 121154
},
{
"countryCode": "SI",
"postalCodes": 556
},
{
"countryCode": "SJ",
"postalCodes": 8
},
{
"countryCode": "SK",
"postalCodes": 5233
},
{
"countryCode": "SM",
"postalCodes": 26
},
{
"countryCode": "TC",
"postalCodes": 1
},
{
"countryCode": "TH",
"postalCodes": 903
}
],
"_note": "Response truncated for documentation purposes"
}
curl --location --request GET 'https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35347/supported+countries' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 邮政编码API - 121个国家邮政编码查询 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
每个端点返回有关邮政编码的详细信息,包括地点名称、地区、省份、坐标和编码之间的距离。验证端点确认邮政编码是否有效,而受支持国家端点列出了所有国家及每个国家可用的邮政编码数量
关键字段包括 `countryCode`、`postalCode`、`place`、`region`、`province`、`latitude`、`longitude` 和 `distanceKm` 或 `distanceMiles` 这些字段提供了关于邮政编码的基本地理和行政信息
响应数据采用JSON格式结构,包含嵌套的地点和距离对象。每个端点返回一致的结构,便于以编程方式解析和利用数据
查找端点提供地点详情和验证状态,距离端点计算邮政编码之间的距离,支持国家端点列出所有国家及其各自的邮政编码数量
用户可以输入带有或不带有空格和破折号的邮政编码。距离端点需要两个邮政编码,而验证端点需要一个。查找端点接受一个邮政编码以获取详细信息
数据的准确性通过来自GeoNames的来源得以维护,GeoNames提供可靠的地理信息。定期更新和验证检查确保数据保持最新和准确
典型的使用案例包括基于位置的服务 物流规划 人口统计分析和在应用程序中验证地址 企业可以利用这些数据来提升客户体验和改善服务交付
用户可以提取特定字段,例如`latitude`和`longitude`用于地图绘制,使用`distanceKm`进行旅行计算,或在表单中验证地址 结构化的JSON格式便于集成到应用程序和服务中