Legentic Scan API
Screening d'investigation rapide pour les workflows automatisés
La Legentic Scan API permet aux organisations de déterminer rapidement si des données d'investigation pertinentes existent dans la plateforme Legentic, sans avoir à récupérer immédiatement les dossiers complets.
Conçue pour la rapidité et l'automatisation, la Scan API aide les assureurs, enquêteurs, analystes fraude et équipes de conformité à effectuer des contrôles d'investigation légers directement depuis leurs propres systèmes et workflows.
En envoyant une requête de recherche telle qu'un numéro de plaque d'immatriculation, un NIV, un numéro de téléphone, une adresse e-mail ou un nom, l'API renvoie :
- Le nombre d'enregistrements correspondants trouvés
- Les informations relatives à l'exécution de la recherche
- Un lien direct permettant d'analyser les résultats dans la Legentic Platform
La Scan API est couramment utilisée comme outil de filtrage et de triage en amont afin d'identifier les dossiers susceptibles de nécessiter une investigation plus approfondie. Elle est particulièrement utile dans les workflows où la rapidité du screening et de la priorisation est importante.
Cas d'utilisation courants
- Filtrage des sinistres à leur réception
- Processus de détection des fraudes
- Vérifications automatisées des antécédents
- Triage des investigations
- Processus de surveillance à haut volume
- Automatisation interne de l'évaluation des risques
Exemple de workflow
- Un nouveau sinistre d'assurance est soumis
- Le système de l'assureur déclenche automatiquement une requête Scan API
- Legentic recherche les données d'investigation associées
- L'API renvoie le nombre de correspondances et un lien d'investigation
- Les dossiers suspects ou à haut risque sont transmis pour analyse
Cela permet aux analystes de se concentrer sur les dossiers les plus susceptibles de nécessiter une investigation approfondie.
Avant de commencer
La Scan API doit d'abord être activée par l'équipe Legentic. Pour obtenir l'accès, veuillez d'abord contacter notre équipe Support à l'adresse support@legentic.com.
Configuration
-> Onglet Quick Start
La section Quick Start de la plateforme contient la documentation des endpoints, les schémas de requête et de réponse ainsi que des exemples d'authentification.
-> Onglet Credentials
Toutes les requêtes API nécessitent une clé API qui peut être générée depuis l'onglet Credentials.
Remarques importantes :
- Les clés API deviennent actives immédiatement après leur création
- Seuls les Administrateur de société peuvent créer ou gérer les identifiants
- Les clés API doivent être stockées de manière sécurisée et ne doivent jamais être exposées publiquement
-> Onglet Usage
Les statistiques d'utilisation sont disponibles dans l'onglet Usage de la plateforme.
Veuillez noter :
- Les données d'utilisation peuvent présenter un léger délai de reporting
- Les recherches importantes portant sur plusieurs pays peuvent augmenter les temps de réponse
- Les recherches excessivement larges peuvent renvoyer des ensembles de résultats très importants
Bonnes pratiques pour les recherches
Pour améliorer la qualité des résultats et l'efficacité des investigations :
-> Utilisez des identifiants exacts lorsque cela est possible
Les identifiants exacts, tels que les plaques d'immatriculation, les NIV, les numéros de téléphone et les adresses e-mail, permettent généralement d'obtenir :
- Des recherches plus rapides
- Des résultats plus précis
- Moins de faux positifs
-> Combinez plusieurs éléments contextuels
La combinaison des identifiants avec :
- Des localisations
- Des codes postaux
- Des villes
- Des descriptions de véhicules
peut améliorer considérablement la pertinence des résultats.
-> Évitez les recherches trop larges
Les recherches générales en texte libre peuvent renvoyer :
- Des ensembles de résultats très importants
- Des correspondances non pertinentes
- Des temps de réponse plus longs
Exemple :
"search_term": "Audi" - cette recherche est généralement trop large pour être utile sur le plan opérationnel.
-> Utilisez les filtres de date et de prix pour les investigations de sinistres
Les filtres de date de publication et de prix peuvent aider à identifier :
- Des périodes pertinentes
- Des incohérences de valeur
- Des schémas d'activité suspects
Foire aux questions
-> La Scan API renvoie-t-elle les dossiers complets ?
Non. La Scan API est volontairement légère et renvoie uniquement :
- Le nombre de correspondances
- Les métadonnées de recherche
- Un lien direct vers l'investigation
-> Puis-je effectuer des recherches dans plusieurs pays à la fois ?
Oui. Plusieurs codes pays peuvent être inclus dans la requête. Vous pouvez également utiliser ["*"] pour rechercher dans tous les pays accessibles.
-> Pourquoi ai-je trop de résultats ?
Cela peut généralement être dû à :
- Des recherches générales en texte libre
- Des filtres manquants
- Des identifiants génériques
Essayez :
- D'ajouter des informations contextuelles
- D'utiliser des identifiants structurés
- D'appliquer des filtres de pays/date
-> Pourquoi n'ai-je aucun résultat ?
Les causes possibles incluent :
- Des recherches trop restrictives
- Des identifiants incorrects
- Des filtres de pays limités
- L'absence de données d'investigation correspondantes
Essayez d'élargir légèrement la recherche ou d'ajuster les filtres.
Support
Si vous avez besoin d'aide concernant :
- L'optimisation de la stratégie de recherche
- La conception des requêtes
- La configuration de l'intégration
- Le dépannage
- L'accès à l'API
veuillez contacter l'équipe Legentic Support à l'adresse support@legentic.com.
Lorsque vous contactez le support, il est utile d'inclure :
- Les horodatages des requêtes
- Les identifiants de dossiers
- Les payloads des requêtes
- Les messages d'erreur
- Des exemples pertinents de réponses