Início rápido da API

Um endpoint, um relatório JSON. Primeira chamada num colar, chave depois.

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: low abaixo de 30, elevated de 30 a 69, high de 70 para cima. high exige pelo menos um sinal de severidade alta.
  • signals[].id e severity: 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