API de CEP

Consulta de endereco por CEP com fallback automatico entre dois provedores publicos.

GET /cep/{cep}

Experimente

Exemplos:

Ver resposta JSON crua

Como funciona (fallback)

Sanitiza a entrada: remove tudo que nao for digito e valida 8 digitos. Sem isso, nem chama as APIs.
Tenta o ViaCEP. Sucesso → devolve.
Qualquer falha do ViaCEP (rede, timeout, HTTP ≠ 200, corpo { "erro": true }, JSON invalido) → tenta a BrasilAPI.
Se os dois falharem → encontrado: false (sem lancar erro).

Parametros

Nome	Onde	Descricao
`cep`	rota	CEP com ou sem mascara (13208056 ou 13208-056). So os digitos importam.

Modelo de saida

Campo	Tipo	Descricao
`encontrado`	bool	false quando os dois provedores falharam ou o CEP e invalido.
`cep`	string	Normalizado, sempre com mascara 00000-000.
`logradouro`	string	Rua/avenida.
`complemento`	string	So ViaCEP; vazio quando vem da BrasilAPI.
`bairro`	string	Bairro.
`cidade`	string	Municipio.
`uf`	string	Estado (2 letras).
`ibge`	string	Codigo IBGE; vazio quando vem da BrasilAPI.
`latitude`	string?	So BrasilAPI v2, quando disponivel.
`longitude`	string?	So BrasilAPI v2, quando disponivel.
`fonte`	string	viacep \| brasilapi \| "" (auditoria).

Codigos HTTP

Status	Quando	Corpo
`200`	CEP encontrado	Modelo com encontrado: true.
`404`	CEP valido mas inexistente nos provedores	Modelo neutro com encontrado: false.
`400`	CEP mal formado (nao 8 digitos)	Modelo neutro com encontrado: false.

Exemplo

curl https://seleapi.sele.com.br/cep/13208056

{
  "encontrado": true,
  "cep": "13208-056",
  "logradouro": "Rua Exemplo",
  "complemento": "",
  "bairro": "Centro",
  "cidade": "Jundiai",
  "uf": "SP",
  "ibge": "3525904",
  "latitude": "-23.18",
  "longitude": "-46.88",
  "fonte": "viacep"
}

Documentacao OpenAPI (Postman/Insomnia/Scalar): /openapi/v1.json