邮政编码API - 121个国家邮政编码查询 API

API ID 14239

121个国家和180万个邮政编码的查询:地点、地区、坐标、两个编码之间的距离和验证

654 ms 平均响应

API 文档

端点

请求
查找邮政编码 查询121个国家和180万个编码的邮政编码:地点名称、地区、省份、坐标;两个邮政编码之间的距离;以及邮政编码验证。接受带空格或破折号的编码
Endpoint ID: 35344
GET https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35344/look+up+a+postal+code
输入参数

剩余免费测试请求:3 / 3。

API 示例响应
JSON
{
    "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' 


    
请求
邮政编码之间的距离。121个国家和180万个代码的邮政编码查询:地点名称、地区、省份、坐标;两个邮政编码之间的距离;以及邮政编码验证。接受带或不带空格和破折号的代码
Endpoint ID: 35345
GET https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35345/distance+between+postal+codes
输入参数

邮政编码之间的距离 — 端点功能

对象 描述
from 必需 COUNTRY:CODE
to 必需 COUNTRY:CODE

剩余免费测试请求:3 / 3。


输入参数

from
to
API 示例响应
JSON
{
    "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' 


    
请求
验证邮政编码 支持121个国家和180万个编码的邮政编码查询:地点名称 区域 省份 坐标 两个邮政编码之间的距离 以及邮政编码验证 接受带空格和连字符的编码
Endpoint ID: 35346
GET https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35346/validate+a+postal+code
输入参数

验证邮政编码 — 端点功能

对象 描述
country 必需 ISO country code
code 必需 Postal code

剩余免费测试请求:3 / 3。


输入参数

country
code
API 示例响应
JSON
{
    "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' 


    
请求
支持的国家 提供121个国家和180万个邮政编码的查询:地点名称 地区 省份 坐标;两个邮政编码之间的距离;邮政编码验证。接受带或不带空格和破折号的编码
Endpoint ID: 35347
GET https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35347/supported+countries
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
JSON
{
    "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 端点。要使用 邮政编码API - 121个国家邮政编码查询 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

起价
$10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

121个国家和180万代码的邮政编码查询:地点、地区、坐标、两个代码之间的距离和验证

邮政编码API - 121个国家邮政编码查询 API FAQs

每个端点返回有关邮政编码的详细信息,包括地点名称、地区、省份、坐标和编码之间的距离。验证端点确认邮政编码是否有效,而受支持国家端点列出了所有国家及每个国家可用的邮政编码数量

关键字段包括 `countryCode`、`postalCode`、`place`、`region`、`province`、`latitude`、`longitude` 和 `distanceKm` 或 `distanceMiles` 这些字段提供了关于邮政编码的基本地理和行政信息

响应数据采用JSON格式结构,包含嵌套的地点和距离对象。每个端点返回一致的结构,便于以编程方式解析和利用数据

查找端点提供地点详情和验证状态,距离端点计算邮政编码之间的距离,支持国家端点列出所有国家及其各自的邮政编码数量

用户可以输入带有或不带有空格和破折号的邮政编码。距离端点需要两个邮政编码,而验证端点需要一个。查找端点接受一个邮政编码以获取详细信息

数据的准确性通过来自GeoNames的来源得以维护,GeoNames提供可靠的地理信息。定期更新和验证检查确保数据保持最新和准确

典型的使用案例包括基于位置的服务 物流规划 人口统计分析和在应用程序中验证地址 企业可以利用这些数据来提升客户体验和改善服务交付

用户可以提取特定字段,例如`latitude`和`longitude`用于地图绘制,使用`distanceKm`进行旅行计算,或在表单中验证地址 结构化的JSON格式便于集成到应用程序和服务中

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API