Documentazione API

Integra il rilevamento delle truffe nella tua applicazione con la nostra API REST.

Autenticazione

Tutte le richieste API richiedono un token Bearer. Ottieni la tua chiave API iscrivendoti al piano API.

Authorization: Bearer your_api_key_here

Endpoint

POST/api/v1/check

Analizza un contenuto alla ricerca di indicatori di truffa.

{
  "content": "Your suspicious text here...",
  "input_type": "text",  // "text" | "url" | "email"
  "locale": "en"         // optional, for explanation language
}

POST/api/v1/bulk

Verifica più URL o elementi di contenuto in un'unica richiesta.

{
  "items": [
    { "content": "https://suspicious-url.com" },
    { "content": "Check this email text..." }
  ]
}

Formato di Risposta

{
  "id": "abc123xyz",
  "verdict": "likely_scam",
  "composite_score": 72,
  "confidence": 88,
  "scam_type": "phishing",
  "explanation": "This message...",
  "red_flags": [...],
  "layers": [...],
  "processing_time_ms": 2340
}

Limiti di Richieste

Piano API: 10.000 richieste al giorno. Piano Enterprise: illimitato.