Guia técnico · Python

Consulta de CEP com Python e FastAPI

Cliente HTTP no backend

Faça a chamada no backend FastAPI para proteger a API key e valide o retorno antes de responder ao seu frontend.

import os
import httpx

async def consultar_cep(cep: str) -> dict:
    async with httpx.AsyncClient(timeout=15) as client:
        response = await client.get(
            f'https://brasiladdress.io/api/v1/cep/{cep}',
            headers={'X-API-Key': os.environ['BRASILADDRESS_API_KEY']},
        )
        response.raise_for_status()
        return response.json()

Validação

Valide o formato do CEP no seu domínio, mas mantenha o tratamento de 422 para a resposta da API. Não use o endpoint para varreduras em massa.