Postal & ZIP Code Validation API (ISO-Country Based)

Validate postal and ZIP codes accurately using ISO-2 country codes. Supports UK, US, EU, and global postcodes with strict validation — no full address lookup.

原始信息汇总

Postal & ZIP Code Validation API (ISO-Country Based) 数据集概述

基本信息

• API名称: Postal & ZIP Code Validation API (ISO-Country Based)
• 类别: Location
• 提供者: alreadycoded
• 订阅者数量: 2
• 流行度评分: 8.9
• 服务等级: 100%
• 延迟: 1118ms
• 测试覆盖率: 100%

定价计划

• BASIC: $0.00 / 月
• PRO: $10.00 / 月
• ULTRA: $30.00 / 月
• MEGA: $50.00 / 月

功能概述

该API使用ISO-2国家代码（US、GB、DE、FR等）验证邮政编码和ZIP码，并进行严格匹配。

• 专注于邮政编码验证，防止误报和不正确的国家匹配。
• 不支持完整地址或POI搜索。
• 快速、轻量且注重隐私（不存储数据）。

主要特性

• 🌍 全球邮政编码/ZIP码验证
• 🏳 ISO-2国家代码强制执行
• 🇬🇧 完整的GB邮政编码支持（例如WC2E 9TB、SW1A 1AA等）
• 🚫 无完整地址或POI搜索
• ⚡ 快速且轻量
• 🔒 隐私友好（无存储）

适用场景

• 注册和结账表单验证
• 运输和物流平台
• CRM和潜在客户验证
• SaaS入职流程

技术细节

认证

• 需要发送 X-RapidAPI-Host 和 X-RapidAPI-Key 请求头。

输入参数

• postal_code (必需): 要验证的邮政编码或ZIP码。支持包括带空格的英国邮政编码在内的全球格式。
• country_code (必需): 用于验证的ISO-2国家代码。API将严格根据此国家验证邮政编码。

响应结构

成功响应示例： json { "success": true, "valid": true, "postal_code": "10001", "country": "United States", "country_code": "US", "state": "New York", "county": "New York County", "city": "New York", "latitude": "40.7485112", "longitude": "-73.9940398", "timestamp": "2026-01-19T12:53:00+01:00" }

无效邮政编码响应示例： json { "success": true, "valid": false, "postal_code": "10001", "country_code": "DE", "message": "Invalid or unknown postal / ZIP code for this country", "timestamp": "2026-01-19T12:53:25+01:00" }

速率限制

• 所有免费计划（如BASIC）限制为 每小时1000次请求。
• 超出速率限制时，API将返回 429 Too Many Requests 错误。

速率限制头部信息

所有API响应包含以下速率限制头部：

• x-ratelimit-requests-limit: 订阅允许的请求总数。
• x-ratelimit-requests-remaining: 达到配额限制前的剩余请求数。
• x-ratelimit-requests-reset: 配额重置前的秒数。

常见HTTP状态码

• 400 Bad Request: 参数缺失或无效。
• 403 Forbidden: API密钥无效或无有效订阅。
• 404 Not Found: 端点无效。
• 429 Too Many Requests: 超出速率限制。
• 5XX Server Error: 临时服务器端问题。

支持与联系

• 支持: 如遇问题，请联系并提供错误代码、消息和请求上下文。
• 联系邮箱: [e-mail]
• 提供商网站: https://www.alreadycoded.com
• 自定义计划: 如需自定义计划、企业用途或高容量请求，请联系提供商。