🚀 Funcionalidades
A API RADIM foi desenvolvida para análise epidemiológica e a geração de relatórios sindrômicos em tempo real. Ela integra dados provenientes de um bucket MinIO, processa as informações e retorna mensagens estruturadas e gráficos codificados em Base64, permitindo fácil integração com sistemas de vigilância em saúde.
O sistema contempla dois grandes eixos de análise:
- RESPAT (Síndromes Respiratórias) → Consolida dados de síndromes respiratórias (covid-19, vsr, influenza A e influenza B), identifica tendências semanais, e gera relatórios automáticos com insights interpretados por modelos de linguagem.
- ARBO (Arboviroses) → Processa informações sobre arboviroses (como Dengue, Chikungunya e Zika), detecta variações semanais e fornece análises quinzenais e semanais, apoiando ações rápidas de vigilância epidemiológica.
Além do processamento, a API conta com:
- Autenticação via API Key → garantindo segurança no consumo dos endpoints.
- Flexibilidade → análises podem ser disparadas sob demanda por request.
- Saída estruturada em JSON → fácil de consumir em outros sistemas, dashboards ou automações (ex: n8n, Supabase, Evolution API).
🔑 Autorização
Todas as requisições exigem cabeçalho:
Authorization: Bearer <API_KEY>
📌 Endpoints
POST /dow
Baixa os arquivos do MinIO e salva na pasta temp/.
curl -X POST https://rp.radim.org.br/dow \
-H "Authorization: Bearer SEU_TOKEN"
POST /respat-s
Gera mensagem semanal das síndromes respiratórias.
curl -X POST https://rp.radim.org.br/respat-s \
-H "Authorization: Bearer SEU_TOKEN"
POST /respat-m
Gera análise quinzenal de RESPAT (parâmetro llm).
curl -X POST https://rp.radim.org.br/respat-m \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"llm":"Texto exemplo"}'
Exemplo da resposta json:
{
"status": "sucesso",
"hora": "2025-09-24 16:30:12",
"corpo": "Mensagem final gerada",
"respat": "BASE64_DA_IMAGEM",
"cabecalho": "Resumo Epidemiológico",
"top1_msg": "Vírus mais prevalente da semana:",
"resposta_p1": "Detalhes sobre o top 1 gerada por llm",
"top2_msg": "Segunda tendência observada",
"resposta_p2": "Detalhes sobre o top 2 gerada por llm",
"outros_msg": "Outros patógenos em menor circulação",
"rodape": "Fonte: e link",
"parametro_llm": "Prompt enviado pelo usuário"
}
Exemplo já formatada, do corpo:
Monitoramento de Patógenos Respiratórios - Semana Epidemiológica 38 (SE38) - de 14 a 20/09/25
🔎 Positividades dos principais vírus respiratórios
🔬 covid-19 🦠
* SE38: 16%
* Em duas semanas, estavel de 0 ponto percentual
* Em um mês, alta de 1 ponto percentual
🔬 influenza A 🦠
* SE38: 13%
* Em duas semanas, alta de 5 pontos percentuais
* Em um mês, alta de 8 pontos percentuais
📌 Outros patógenos
vírus sincicial respiratório (VSR): 1%, queda
influenza B: 1%, alta
🔗 Confira as análises completas: https://www.itps.org.br/pesquisa-detalhe/historico-de-surtos-de-patogenos-respiratorios
POST /arbo-s
Gera mensagem semanal das arboviroses.
curl -X POST https://rp.radim.org.br/arbo-s \
-H "Authorization: Bearer SEU_TOKEN"
POST /arbo-m
Gera análise quinzenal de ARBO (parâmetro llm).
curl -X POST https://rp.radim.org.br/arbo-m \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"llm":"Texto exemplo"}'
Exemplo da resposta json:
{
"status": "sucesso",
"hora": "2025-09-24 16:30:12",
"corpo": "Mensagem final gerada",
"respat": "BASE64_DA_IMAGEM",
"cabecalho": "Resumo Epidemiológico",
"top1_msg": "Vírus mais prevalente da semana:",
"resposta_p1": "Detalhes sobre o top 1 gerada por llm",
"top2_msg": "Segunda tendência observada",
"resposta_p2": "Detalhes sobre o top 2 gerada por llm",
"outros_msg": "Outros patógenos em menor circulação",
"rodape": "Fonte: e link",
"parametro_llm": "Prompt enviado pelo usuário"
}
Exemplo já formatada, do corpo:
🦟 *Monitoramento Atualizado - Semana Epidemiológica 38 (SE38 - Set) de 14 a 20/09/25
🔎 Positividades das principais Arboviroses
🔬 chikungunya 🦠
* SE38 - Set: 14%
* Em duas semanas, queda de 4 pontos percentuais
* Em um mês, queda de 7 pontos percentuais
🔬 dengue 🦠
* SE38 - Set: 1%
* Em duas semanas, queda de 1 ponto percentual
* Em um mês, queda de 1 ponto percentual
🔗 Confira as análises completas: https://www.itps.org.br/pesquisa/monitoramento-de-arboviroses