Minha API de CEPs — Consulta de Endereços por CEP

Consulta rápida de CEP

Digite um CEP e clique em Consultar.

Visão geral

Com essa API, você pode consultar dados de endereço (logradouro, bairro, cidade, UF, IBGE) a partir de um CEP (somente números). A resposta é em JSON e pode ser integrada em qualquer linguagem.

GETConsulta por CEP

https://meucep.seunegocionanuvem.com.br/api/{CEP}

Parâmetro	Obrigatório	Descrição
`cep`	Sim	Somente números, 8 dígitos. Ex.: `36240075`

Exemplo de retorno 200:

{
  "cep": "36240-075",
  "logradouro": "Avenida Presidente Getúlio Vargas",
  "complemento": "lado ímpar",
  "unidade": null,
  "bairro": "Centro",
  "localidade": "Santos Dumont",
  "uf": "MG",
  "ibge": "3160702",
  "ddd": "32",
  "siafi": "5213"
}

Erros

Status	Significado
400	CEP inválido ou formato incorreto.
404	CEP não encontrado.
500	Erro interno no servidor.

{
  "erro": "CEP inválido"
}

Exemplos de integração

<?php
$cep = '01457000';
$url = "https://meucep.seunegocionanuvem.com.br/api/{$cep}";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);

$data = json_decode($result, true);
if (isset($data['erro'])) {
  echo "Erro: " . $data['erro'];
} else {
  echo "Logradouro: " . $data['logradouro'];
}

fetch('https://meucep.seunegocionanuvem.com.br/api/36240075')
  .then(r => r.json())
  .then(json => {
    if (json.erro) {
      console.error('Erro:', json.erro);
    } else {
      console.log('Bairro:', json.bairro);
    }
  });

import requests
resp = requests.get('https://meucep.seunegocionanuvem.com.br/api/36240075')
data = resp.json()
if 'erro' in data:
    print('Erro:', data['erro'])
else:
    print('Cidade:', data['localidade'])

Dicas e boas práticas

Use cache

Guarde o resultado no seu aplicativo: não consulte a API a todo momento para o mesmo CEP.

Trate erros

Considere respostas de erro e defina um tempo limite (timeout) nas requisições.