# Aplicação para buscar previsão do tempo - Parte 1

Nesses próximos dias vamos construir uma aplicação que será utilizada através de uma CLI que consulta uma API e exibe os dados de resultado. Vamos usar como base a BrasilAPI. Fazer uma CLI onde podemos buscar a previsão do tempo das cidades do Brasil, para isso teremos dois comando principais, buscar ID da cidade e buscar a previsão da cidade com base nesse ID. Podemos incrementar a aplicação, mas o básico será isso. Veja como funcionam as rotas:

# Buscar cidade

A rota https://brasilapi.com.br/api/cptec/v1/cidade/{cityName} retorna uma lista com as cidades correspondentes ao termo cityName, nos objetos são retornados “nome”, “estado” e “id”, esse “id” que será utilizado para buscar a previsão do tempo. Veja com o CURL:

curl https://brasilapi.com.br/api/cptec/v1/cidade/Curitiba

Retorno

[
    {"nome":"Curitiba","id":227,"estado":"PR"},
    {"nome":"Curitibanos","id":1728,"estado":"SC"}
]

# Buscar previsão do tempo

Para buscar a previsão do tempo utilizamos o campo “id” da rota de busca de cidades e passamos como parâmetro para a rota de previsão do tempo https://brasilapi.com.br/api/cptec/v1/clima/previsao/{cityCode}.

curl https://brasilapi.com.br/api/cptec/v1/clima/previsao/227

Retorno

{
  "cidade": "Curitiba",
  "estado": "PR",
  "atualizado_em": "2025-04-25",
  "clima": [
    {
      "data": "2025-04-26",
      "condicao": "pn",
      "condicao_desc": "Parcialmente Nublado",
      "min": 14,
      "max": 24,
      "indice_uv": 0
    }
  ]
}

# Passos do projeto:

1. Criar a base do CLI
2. Implementar o comando para buscar cidades
3. Implementar o comando para buscar previsão
4. Tratar erros e melhorar a UX no terminal
5. Criar logs para todas as operações
6. Adicionar testes