O POST /api/v1/inspect recebe um documento ou uma imagem e
devolve sinais estruturais de risco de fraude em JSON. O resto está na
referência da API.
1. Analise um documento
curl -s https://tamperlens.com/api/v1/inspect -F [email protected]
Sem chave, sem conta: 10 documentos por hora por IP, relatório completo. PDFs, documentos do Office e imagens, até 10 MB; um corpo bruto substitui o multipart.
2. Leia o relatório
{
"summary": { "riskScore": 95, "riskBand": "high", "signalCount": 2 },
"signals": [
{ "id": "incremental-updates", "severity": "high", "title": "…", "evidence": {…} }
]
}
-
summary.riskBand: a decisão de roteamento:lowabaixo de 30,elevatedde 30 a 69,highde 70 para cima.highexige pelo menos um sinal de severidade alta. -
signals[].ideseverity: ids de família estáveis. Ramifique neles quando uma família pesar mais no seu fluxo que a nota isolada. -
signals[].evidence. Guarde. É pequeno, não contém conteúdo do documento e é o que um analista precisa.
A Tamperlens reporta sinais de risco, não veredictos de autenticidade. Sinais podem ter causas legítimas; combine-os com a sua própria lógica de decisão.
3. Pegue uma chave
Crie uma conta, e-mail e senha, sem cartão. A
chave Free sai na hora: 50 documentos por mês, exibida uma vez. Enviada
como -H "Authorization: Bearer tl_…", a chamada é medida
contra a sua cota, não contra o limite por IP.
curl -s https://tamperlens.com/api/v1/auth/signup \
-H 'Content-Type: application/json' \
-d '{"email":"[email protected]","password":"uma-senha-longa-o-suficiente"}'
# -> {"user":{…},"apiKey":{"plaintext":"tl_…","plan":"free","quota":50}}
Próximos passos
- Referência da API Autenticação, requisições, baselines, relatório anotado, erros, limites.
- Sua política de veredicto Limiares de revisão e rejeição na requisição; a resposta traz a sua decisão.
- Para agentes (MCP) Cheque o documento antes que o agente o leia: três ferramentas MCP.
- OpenAPI explorer Especificação legível por máquina e console de teste (em inglês).
- Guia de campo dos sinais Cada família, suas evidências, suas causas legítimas e regras de severidade.
- Preços Planos, cotas e o que conta como um documento.