Legentic Scan API

La Legentic Scan API consente alle organizzazioni di determinare rapidamente se nella piattaforma Legentic sono presenti dati investigativi rilevanti, senza dover recuperare immediatamente i record completi.

Progettata per velocità e automazione, la Scan API aiuta assicuratori, investigatori, analisti di frodi e team di compliance a eseguire controlli investigativi leggeri direttamente dai propri sistemi e flussi di lavoro.

Inviando una query di ricerca, ad esempio un numero di targa, VIN, numero di telefono, indirizzo e-mail o nome, l'API restituisce:

• Il numero di record corrispondenti trovati
• Informazioni sull'esecuzione della ricerca
• Un link diretto per analizzare i risultati nella Legentic Platform

La Scan API viene comunemente utilizzata come strumento di filtraggio e triage nelle fasi iniziali, per identificare i casi che potrebbero richiedere un'indagine più approfondita. È particolarmente utile nei flussi di lavoro in cui sono importanti uno screening e una prioritizzazione rapidi.

Casi d'uso tipici

• Screening dei sinistri in fase di apertura
• Flussi di rilevamento delle frodi
• Controlli automatizzati dei precedenti
• Triage delle indagini
• Processi di monitoraggio ad alto volume
• Automazione interna della valutazione del rischio

Esempio di flusso di lavoro

• Viene presentato un nuovo sinistro assicurativo
• Il sistema dell'assicuratore attiva automaticamente una richiesta alla Scan API
• Legentic verifica la presenza di dati investigativi correlati
• L'API restituisce il numero di corrispondenze e un link per l'indagine
• I casi sospetti o ad alto rischio vengono sottoposti a revisione

Questo consente agli analisti di concentrarsi sui casi che hanno maggiori probabilità di richiedere un'indagine più approfondita.

Prima di iniziare

La Scan API deve essere prima abilitata dal team Legentic. Per ottenere l'accesso, contatta innanzitutto il nostro team Support all'indirizzo support@legentic.com.

Configurazione

-> Scheda Quick Start

La sezione Quick Start all'interno della piattaforma include la documentazione degli endpoint, gli schemi delle richieste e delle risposte e gli esempi di autenticazione.

-> Scheda Credentials

Tutte le richieste API richiedono una chiave API, che può essere generata dalla scheda Credentials.

Note importanti:

• Le chiavi API diventano attive immediatamente dopo la creazione
• Solo i Company Admin possono creare o gestire le credenziali
• Le chiavi API devono essere conservate in modo sicuro e non devono mai essere esposte pubblicamente

-> Scheda Usage

Le statistiche di utilizzo sono disponibili nella scheda Usage all'interno della piattaforma.

Nota:

• I dati di utilizzo potrebbero presentare un lieve ritardo nella reportistica
• Le ricerche estese su più Paesi possono aumentare i tempi di risposta
• Le ricerche eccessivamente ampie possono restituire set di risultati molto grandi

Best practice per le ricerche

Per migliorare la qualità dei risultati e l'efficienza investigativa:

-> Utilizza identificatori esatti quando possibile

Gli identificatori esatti, come targhe, VIN, numeri di telefono e indirizzi e-mail, generalmente offrono:

• Ricerche più rapide
• Risultati più precisi
• Meno falsi positivi

-> Combina più elementi contestuali

Combinare gli identificatori con:

• Località
• CAP
• Città
• Descrizioni dei veicoli

può migliorare significativamente la rilevanza dei risultati.

-> Evita ricerche eccessivamente ampie

Le ricerche generiche in testo libero possono restituire:

• Set di risultati molto grandi
• Corrispondenze non pertinenti
• Tempi di risposta più lunghi

Esempio:

"search_term": "Audi" - questa ricerca è generalmente troppo ampia per essere utile dal punto di vista operativo.

-> Utilizza i filtri per data e prezzo nelle indagini sui sinistri

I filtri per data di pubblicazione e prezzo possono aiutare a identificare:

• Cronologie pertinenti
• Incongruenze di valore
• Modelli di attività sospette

Domande frequenti

-> La Scan API restituisce i record completi?

No. La Scan API è intenzionalmente leggera e restituisce solamente:

• Numero di corrispondenze
• Metadati della ricerca
• Un link diretto per l'indagine

-> Posso effettuare ricerche in più Paesi contemporaneamente?

Sì. È possibile includere nella richiesta più codici Paese. È inoltre possibile utilizzare ["*"] per effettuare una ricerca in tutti i Paesi accessibili.

-> Perché ottengo troppi risultati?

Generalmente ciò può essere causato da:

• Ricerche generiche in testo libero
• Filtri mancanti
• Identificatori generici

Prova a:

• Aggiungere informazioni contestuali
• Utilizzare identificatori strutturati
• Applicare filtri per Paese/data

-> Perché non ottengo risultati?

Le possibili cause includono:

• Ricerche eccessivamente restrittive
• Identificatori errati
• Filtri Paese limitati
• Assenza di dati investigativi corrispondenti

Prova ad ampliare leggermente la ricerca o a modificare i filtri.

Supporto

Se hai bisogno di assistenza per:

• Ottimizzazione della strategia di ricerca
• Progettazione delle query
• Configurazione dell'integrazione
• Risoluzione dei problemi
• Accesso API

contatta il team Legentic Support all'indirizzo support@legentic.com.

Quando contatti il supporto, è utile includere:

• Timestamp delle richieste
• ID dei casi
• Payload delle richieste
• Messaggi di errore
• Esempi pertinenti delle risposte