Inconsistência nas respostas da API do CPTEC para ICAO Codes válidos e inexistentes
Author: NibaacribaCreated Oct 5, 2025Updated Aug 8, 2026
Descrição do Problema
Durante os testes de integração com a API de condições meteorológicas do CPTEC, foram identificados comportamentos inconsistentes relacionados à validação e retorno de dados com base nos ICAO Codes informados.
Mesmo quando fornecidos:
- ICAO Codes válidos, a API retorna dados incorretos ou incompatíveis com as condições esperadas;
- ICAO Codes inexistentes (ex:
ZZZZ), a API não retorna erro apropriado (AIRPORT_CONDITIONS_NOT_FOUND), mas sim dados genéricos, dificultando a detecção de falhas.
✅ Comportamento Esperado
- Para ICAO Codes inexistentes → Deve ser retornado erro padronizado (
AIRPORT_CONDITIONS_NOT_FOUND). - Para ICAO Codes válidos → Deve ser retornado um payload consistente com os dados reais do aeroporto correspondente.
Comportamento Atual
| Cenário | Input | Resultado Atual | Resultado Esperado |
|---|---|---|---|
| ICAO válido com dados reais | SBGR |
Retorna dados inconsistentes | Retornar dados corretos |
| ICAO inexistente | ZZZZ |
Retorna payload genérico | Retornar erro (AIRPORT_CONDITIONS_NOT_FOUND) |
| ICAO com formato válido mas sem dados disponíveis | SXXX |
Retorna resposta ambígua | Retornar resposta com estado de ausência de dados |
Impactos Identificados
- Dificuldade no tratamento de erros.
- Impossibilidade de distinguir ausência de dados vs. retorno inválido.
- Risco de exibição de dados incorretos para o usuário final.
Como Reproduzir
GET /api/cptec/v1/clima/aeroporto/ZZZZ // icao code inválidoOu
GET /api/cptec/v1/clima/aeroporto/SBGR //icao code válidoSource: BrasilAPI/BrasilAPI