AddressFormat

Format shipping addresses into country-conformant labels. 35 countries, UPU-compliant country names, bulk endpoint. No database required — deterministic output. # address formatting # api # structured shippinglabel

原始信息汇总

数据集概述：AddressFormat API

API 名称： AddressFormat
所属类别： Logistics（物流）
提供方： SBE Retail
平台地址： https://rapidapi.com/SBERetail/api/addressformat

---

核心功能

将结构化的地址字段转换为符合目标国家本地规范的格式化地址标签，支持 35 个国家的地址格式，输出结果可直接用于打印、邮件或网页展示。

关键能力包括：

• 35 个支持国家：覆盖欧洲（22 国）、美洲（4 国）、亚太（6 国）、中东与非洲（3 国）
• UPU 合规输出：国际包裹自动使用发件人语言输出收件国名，符合万国邮政联盟标准
• 3 种输出格式：label（换行分隔，适合打印）、html（<br> 分隔，适合网页/邮件）、oneline（逗号分隔）
• 邮编规范化：自动按国家规则调整邮编格式（如荷兰 1012LG → 1012 LG，加拿大 K1A0B1 → K1A 0B1）
• 国家元数据端点：可动态获取每个国家的必填字段、邮编正则表达式和示例，用于构建自适应的结账表单
• 批量端点：单次调用最多处理 1000 个地址
• 验证警告：输入不符合该国格式规范时会返回警告信息

---

支持的国家列表（35 国）

• 欧洲（22 国）：NL, BE, LU, DE, AT, CH, FR, MC, UK, GB, IE, IT, ES, PT, GR, PL, CZ, HU, SE, DK, NO, FI
• 美洲（4 国）：US, CA, BR, MX
• 亚太（6 国）：AU, NZ, JP, SG, HK, IN
• 中东与非洲（3 国）：AE, IL, ZA

---

典型应用场景

• 电商结账环节：根据用户所在国家动态显示地址输入字段，客户端验证邮编格式，服务端生成标准化标签
• 跨境物流：自动使用发件人语言输出 UPU 合规的收件国名称
• 标签打印软件：一次 API 调用即可获得即打即用的字符串，无需维护 35 个国家模板
• 多国 SaaS 平台：在发票、装箱单、账户页面中正确渲染地址

---

使用示例（荷兰国内地址）

请求：

json { "recipient": "Jan de Vries", "street": "Damrak", "house_number": "70", "postal_code": "1012LG", "city": "Amsterdam", "country": "NL" }

响应：

json { "formatted": "Jan de Vries Damrak 70 1012 LG Amsterdam", "lines": ["Jan de Vries", "Damrak 70", "1012 LG Amsterdam"], "warnings": [] }

---

国家特殊规则示例

• 日本：使用罗马字表示，格式为 CITY-KU, PREFECTURE POSTCODE
• 波兰：自动在街道名前加 ul.，邮编格式为 NN-NNN
• 巴西：CEP 独立一行，州名在城市后以连字符分隔
• 加拿大：全大写，邮编格式为 A1A 1A1
• 瑞典：国内 NNN NN，国际加前缀 SE-NNNNN
• 匈牙利：独特顺序——城市在街道上方，邮编在末行
• 新加坡：公寓号变为 #NN-NN，最后一行格式为 SINGAPORE NNNNNN
• 香港：无邮编，区域名在最后一行

---

认证与使用方式

• 需在 RapidAPI 上订阅计划，并通过 HTTP 请求头 X-RapidAPI-Key 传递密钥
• 免费套餐可用于测试和小型项目，付费套餐可扩展流量

---

定价计划

• BASIC：$0.00/月
• PRO：$9.99/月
• ULTRA：$32.99/月

（具体限流规则请参考 Pricing 标签页）