v1.0REST API
Integracao Simples. Resultado Estruturado.
A API permite integrar a analise antifraude diretamente ao seu fluxo de validacao. Implementacao rapida com retorno estruturado para sistemas internos.
POST
/api/analyzeDescricao
Analisa um boleto, codigo Pix ou URL e retorna o score de risco, categoria e motivos detalhados.
Request Body
{
"tipo": "boleto" | "pix" | "link", // opcional
"texto": "conteudo a ser analisado"
}O campo tipo e opcional. Se nao informado, o sistema detecta automaticamente.
Response
{
"tipo": "link",
"risco": "ALTO_RISCO",
"score": 82,
"categoria": "phishing",
"motivos": [
"URL usa endereco IP direto em vez de dominio",
"Dominio imita instituicao financeira (itau)"
],
"confianca": 0.91
}Campos da Resposta
| Campo | Tipo | Descricao |
|---|---|---|
| tipo | string | boleto, pix, link ou desconhecido |
| risco | string | SEGURO, SUSPEITO, ALTO_RISCO ou INCONCLUSIVO |
| score | number | 0 a 100, onde maior = mais arriscado |
| categoria | string | phishing, boleto_adulterado, pix_suspeito, dominio_falso, inconclusivo ou seguro |
| motivos | string[] | Lista de motivos da classificacao em portugues |
| confianca | number | 0.0 a 1.0, nivel de confianca da analise |
Score de Risco
O score e um numero de 0 a 100 que indica o nivel de risco do conteudo analisado:
0-29: Baixo risco (SEGURO)
30-59: Risco moderado (SUSPEITO)
60-100: Alto risco (ALTO_RISCO)
Categorias
phishingTentativa de roubo de dados via site falsoboleto_adulteradoBoleto com linha digitavel modificadapix_suspeitoCodigo Pix com padroes suspeitosdominio_falsoURL usando dominio nao confiavelinconclusivoAnalise nao identificou padroes clarosseguroNenhum padrao de risco identificadoExemplos de Integracao
cURL
curl -X POST https://detetivedegolpes.com.br/api/analyze \
-H "Content-Type: application/json" \
-d '{"texto": "http://192.168.1.1/itau-login"}'JavaScript (fetch)
const response = await fetch('/api/analyze', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
texto: '23793.38128 60000.000003 00000.000400 1 84340000012345'
})
});
const data = await response.json();
if (data.score >= 60) {
// Bloquear transacao
console.log('Alto risco:', data.motivos);
} else if (data.score >= 30) {
// Solicitar confirmacao adicional
console.log('Risco moderado:', data.categoria);
}