Brazilian ZIP code Lookup API

Instantly retrieve address data from Brazilian ZIP codes. Fast and reliable.

原始信息汇总

Brazilian ZIP code Lookup API 数据集概述

基本信息

• API名称: Brazilian ZIP code Lookup API
• 提供商: cauã paduani
• 订阅人数: 1
• 类别: Mapping
• 价格方案:
  • BASIC: $0.00 / mo
  • PRO: $9.00 / mo
  • ULTRA: $29.00 / mo
  • MEGA: $99.00 / mo

功能概述

• 主要功能: 通过巴西邮政编码（CEP）快速检索详细地址信息。
• 特点:
  • 快速、轻量级且可靠
  • 内置本地缓存以减少响应时间和外部请求
  • 支持高吞吐量或重复查询

数据字段

返回的地址信息包括:

• 街道 (logradouro)
• 社区 (bairro)
• 城市 (localidade)
• 州 (UF)
• 补充信息 (complemento)
• 区号 (DDD)

技术细节

• 基础URL: https://br-cep-lookup-api-1.onrender.com
• 端点: GET /{cep}
  • 参数:
    • cep: 字符串类型，格式为 01001000（必需）
  • 示例请求: GET https://br-cep-lookup-api-1.onrender.com/01001000
  • 示例响应: json { "cep": "01001-000", "logradouro": "Praça da Sé", "complemento": "lado ímpar", "bairro": "Sé", "localidade": "São Paulo", "uf": "SP", "ibge": "3550308", "gia": "1004", "ddd": "11", "siafi": "7107" }

错误处理

• HTTP 400: 无效的CEP格式
• HTTP 404: CEP不存在
• HTTP 500: 内部服务器错误

使用场景

• 电子商务结账表单
• 物流和配送应用
• CRM地址自动填充
• 数据验证管道
• 巴西基于位置的服务

认证

• 通过RapidAPI使用时需在请求头中包含API密钥: http x-rapidapi-key: YOUR_API_KEY x-rapidapi-host: br-cep-lookup-api.p.rapidapi.com

技术支持

• 通过GitHub或RapidAPI支持寻求帮助

技术栈

• FastAPI: Python Web框架
• Uvicorn: ASGI服务器
• Requests: 外部CEP查询
• 自定义本地缓存: 优化性能

开发者注意事项

• CEP需不带破折号或点（如 01001000）
• 本地缓存为内存缓存，应用重启后重置
• 无效或不存在的CEP将返回404