API de consulta na lista de resíduo sólidos

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 uma API. 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.1):

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

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

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

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

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

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

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

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

Link do site para gerenciamento e criação de conta: https://residuoapi.com.br/

Exemplo de Resposta (JSON):
{
“codigo”: “1”,
“codigoLimpo”: “1”,
“nivel”: 1
“descricao”: “Residuo da prospecção…”,
“classificação”: null,
“perigoso”: false,
“unidade”: null
}

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

Email: filipetavaresluiz@gmail.com