Tempo / Clima

Previsão do tempo atual e para os próximos dias com fallback.

Endpoint Base tempo.apibrasil.pro Autenticação API Key (Bearer) Formato JSON Rate Limit 100 req/min

Endpoints

GET /tempo/{cidade}

Consulta clima atual de uma cidade

Parâmetros

Nome Tipo Obrigatório Descrição
cidade string ✅ Sim Nome da cidade (ex: São Paulo, Rio de Janeiro)

Exemplo de Requisição

curl -X GET "https://tempo.apibrasil.pro/tempo/Sao%20Paulo" -H "Authorization: Bearer sua_api_key"

Exemplo de Resposta

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Tempo / Clima"
  }
}
GET /previsao/{cidade}

Consulta previsão para os próximos dias

Parâmetros

Nome Tipo Obrigatório Descrição
cidade string ✅ Sim
dias number ❌ Não Número de dias (1-7, padrão: 7)

Exemplo de Requisição

curl -X GET "https://tempo.apibrasil.pro/previsao/Sao%20Paulo?dias=5" -H "Authorization: Bearer sua_api_key"

Exemplo de Resposta

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Tempo / Clima"
  }
}
GET /clima/coordenadas/{lat}/{lon}

Consulta clima por coordenadas geográficas

Parâmetros

Nome Tipo Obrigatório Descrição
lat number ✅ Sim Latitude (-90 a 90)
lon number ✅ Sim Longitude (-180 a 180)

Exemplo de Requisição

curl -X GET "https://tempo.apibrasil.pro/clima/coordenadas/-23.5505/-46.6333" -H "Authorization: Bearer sua_api_key"

Exemplo de Resposta

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Tempo / Clima"
  }
}
GET /api/health

Health check da API

Exemplo de Requisição

curl -X GET "https://tempo.apibrasil.pro/api/health"

Exemplo de Resposta

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Tempo / Clima"
  }
}