DEV Community

Luiz Filipe Tavares
Luiz Filipe Tavares

Posted on

Criei uma API gratuita para consultar a Lista Brasileira de Resíduos do IBAMA

Fala, pessoal!

Em um projeto recente, deparei-me com um gargalo chato: precisava analisar e validar manualmente a extensa Lista Brasileira de Resíduos do IBAMA. Fazer esse processo "na unha" ou depender de buscas manuais consumia um tempo precioso.

Para resolver essa dor, desenvolvi a API Lista Brasileira de Resíduos Sólidos (IBAMA). A ideia é permitir que qualquer dev ou sistema consulte a descrição, periculosidade e hierarquia de um resíduo via requisições simples e rápidas.

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

Rotas disponíveis na v1.0:
GET /residuos — Lista geral de resíduos cadastrados.

GET /residuos?nivel=3&perigoso=true — Filtro avançado por nível hierárquico e periculosidade.

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

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

GET /residuos/:codigo — Busca pelo código oficial (ex: 01 01 01).

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

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

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

Exemplo de Resposta (JSON):

{
"codigo": "1",
"codigoLimpo": "1",
"nivel": 1,
"descricao": "Resíduo da prospecção...",
"classificacao": null,
"perigoso": false,
"unidade": null
}
A API é gratuita para uso inicial e testes. Como é a v1.0, todo feedback, crítica sobre a estrutura dos endpoints ou sugestão de melhoria é super bem-vindo!

Top comments (0)