api-cep's Introduction

Documentação da API apicep

Essa é uma API desenvolvida por Leandro Sobral, um desenvolvedor Node.js, para consulta de CEP utilizando as tecnologias Express e Axios.

Informações do Criador

Nome: Leandro Sobral
Email: [email protected]
LinkedIn: https://www.linkedin.com/in/ulss/
Portfólio: https://uleandrosobrals.github.io/leandrosobral/
WhatsApp: 79981447870

Instalação

Para executar a API em seu ambiente local, siga os passos abaixo:

Clone o repositório do projeto:

git clone https://github.com/uleandrosobrals/api-cep

Acesse o diretório do projeto:

cd api-cep

Instale as dependências:

npm install

Inicie o servidor local:

npm run dev

A API estará disponível em http://localhost:3000 para ser consumida.

Endpoints

Consultar CEP

Descrição: Consulta um CEP específico.
URL: /cep/{cep}
Método: GET
Parâmetros de URL:
- {cep} (obrigatório): CEP a ser consultado.

Respostas:

Código de Status: 200

Descrição: Sucesso
Corpo da Resposta:

{
  "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"
}

Código de Status: 500
- Descrição: Erro
- Corpo da Resposta:
```
{
  "error": "Erro ao consultar o CEP"
}
```

Tecnologias Utilizadas

Axios (^1.3.6)
Bootstrap (^5.2.3)
Express (^4.18.2)

Espero que isso seja útil! Lembre-se de atualizar as informações do criador, as descrições dos endpoints e as tecnologias utilizadas de acordo com o seu projeto.

Recommend Projects