Pitch: Transformei um problema real em uma API para a Lista Brasileira de Resíduos do IBAMA

Fala, pessoal!

Recentemente, em um dos meus projetos de desenvolvimento, deparei-me com um grande gargalo: eu precisava analisar e validar manualmente uma extensa lista de resíduos do IBAMA. Fazer esse processo na unha ou depender de buscas lentas consumia um tempo precioso de desenvolvimento.

Para resolver essa dor, criei a API Lista Brasileira de Resíduos Sólidos (IBAMA). A ideia é simples e direta: permitir que qualquer desenvolvedor ou sistema consulte a descrição, periculosidade e hierarquia de um resíduo através de requisições simples em tempo real.

O projeto está na sua v1.0 (hospedado e funcional), cobrindo mais de 1.000 itens mapeados, e continuará recebendo atualizações frequentes.

O que você pode fazer com as rotas atuais (v1.0):

GET /residuos — Lista geral de resíduos cadastrados.

GET /residuos?nivel=3&perigoso=true — Filtro avançado por nível na hierarquia e indicador de periculosidade.

GET /residuos/busca?q=termo — Pesquisa textual por palavra-chave ou descrição.

GET /residuos/perigosos — Retorna apenas a listagem de resíduos classificados como perigosos.

GET /residuos/:codigo — Busca direta pelo código oficial do resíduo (ex: 01 01 01).

GET /residuos/:codigo/filhos — Mapeia os sub-itens e a árvore de hierarquia de um código específico.

GET /notas — Consulta as observações e notas explicativas oficiais do IBAMA.

Link para testar a API: https://residuoapi.onrender.com

A API é gratuita para testes e uso inicial. Toda sugestão, feedback ou PR para contribuir com a evolução do projeto é super bem-vinda!

Email: filipetavaresluiz@gmail.com