PNA API (Postal Code API)

Poczta polska PNA (Pocztowe Numery Adresowe). Polish postal codes.
This API provides advanced search capabilities for Polish Postal Codes (PNA), addresses, and address validation. The database is optimized for high-performance querying, handling the specific nuances of Polish building numbering (e.g., alphanumeric numbers 2a, even/odd ranges 12-20(p)).

原始信息汇总

PNA API (Postal Code API) 数据集概述

基本信息

• 数据集名称: PNA API (Postal Code API)
• 类别: Location
• 提供商: Sebi Bin
• 订阅者数量: 1
• API版本: v1 (current)
• 服务等级: 100%
• 平均延迟: 95ms
• 测试覆盖率: 100%
• 受欢迎度评分: 8.7

功能描述

这是一个高性能的波兰邮政编码（PNA）搜索、地址验证和自动补全建议API。该API针对精确的门牌号匹配（范围、奇偶逻辑）进行了优化。

订阅计划与定价

• BASIC: $0.00 / 月
• PRO: $5.00 / 月
• ULTRA: $12.00 / 月
• MEGA: $24.00 / 月

认证方式

所有请求都需要API密钥（请求头）或Bearer令牌。

• API Key: 请求头 X-Rapid-Secret
• Bearer Token: 请求头 Authorization

端点（Endpoints）

1. 搜索邮政编码 (GET)

• 端点: GET /pna/search
• 功能: 根据地址详细信息查找PNA。支持门牌号。
• 必需参数:
  • city: 城市名称
• 可选参数:
  • street: 街道名称
  • number: 门牌号

2. 搜索邮政编码 (POST)

• 端点: POST /pna/search
• 功能: 使用JSON正文进行高级搜索。建议用于复杂查询。
• 请求体示例: json { "city": "Białystok", "street": "Mikołaja Kopernika", "number": "2a", "province": "podlaskie" }

3. 根据代码获取地址 (GET)

• 端点: GET /pna/code/{postalCode}
• 功能: 检索分配给特定邮政编码的所有街道。

4. 根据代码获取地址 (POST)

• 端点: POST /pna/code
• 功能: 检索JSON正文中发送的邮政编码对应的地址。
• 请求体示例: json { "postal_code": "54-210" }

5. 街道自动补全

• 端点: GET /pna/autocomplete/streets
• 功能: 获取实时街道建议。
• 参数:
  • query: 部分街道名称（至少2个字符）
  • city: 按城市筛选（可选）

6. 城市自动补全

• 端点: GET /pna/autocomplete/cities
• 功能: 获取实时城市建议。
• 参数:
  • query: 部分城市名称

AI集成

此API已为AI做好准备。可使用以下端点获取LLM上下文：

• GET /pna/ai-guide: 语义指令
• GET /.well-known/ai-plugin.json: OpenAI插件清单