API de détection de fraude

API de détection de fraude en temps réel

Un seul appel renvoie les signalements de fraude, un score de risque et des alertes en direct pour tout VIN ou plaque.

Obtenir une clé API

300

req/min

10K

req/jour

simultanées

99.9%

disponibilité

Démarrage rapide

# Authenticate & run a scan

curl -X POST https://api.vindetector.com/v1/scans \

-H "Authorization: Bearer YOUR_API_KEY" \

-H "X-Detector-Key: YOUR_DETECTOR_KEY" \

-H "Content-Type: application/json" \

-d '{"vin": "WBA3A5G59DNP26082", "country": "FR"}'

# Response

{"scan_id": "scn_9d4f12",

"vin": "WBA3A5G59DNP26082",

"risk_score": 78, "risk_level": "high",

"fraud_flags": ["mileage_rollback", "salvage_title"],

"checks": {"rollback_detected": true, "stolen": false}}

Points d'accès

Points d'accès de l'API

POST/v1/scans

Lance un scan anti-fraude sur un VIN ou une plaque et renvoie chaque signalement détecté. Le corps prend un vin ou plate et un country.

# Example request

curl -X POSThttps://api.vindetector.com/v1/scans \

-H "Authorization: Bearer YOUR_API_KEY" \

-H "X-Detector-Key: YOUR_DETECTOR_KEY"\

-d '{"vin": "WBA3A5G59DNP26082", "country": "FR"}'

GET/v1/scans/

Récupère un scan déjà exécuté via son scan_id, avec le détail complet du risque.

POST/v1/scans/batch

Scanne plusieurs véhicules en un seul appel. Le corps prend un tableau identifiers de VIN ou plaques.

GET/v1/vehicles//risk

Renvoie uniquement le score et le niveau de risque agrégés d'un véhicule, sans la charge complète.

GET/v1/vehicles//flags

Liste uniquement les signalements de fraude d'un véhicule, avec les contrôles associés.

Schéma

Schéma de réponse

Chaque scan renvoie un objet JSON structuré avec les champs de détection de fraude suivants.

scan_idstringIdentifiant unique du scan, préfixé scn_

vinstringNuméro d'identification du véhicule scanné

scanned_atstringHorodatage ISO 8601 de l'exécution du scan

risk_scoreintegerRisque de fraude agrégé de 0 (sain) à 100 (risque élevé)

risk_levelstringNiveau de risque : low, medium, high ou critical

fraud_flagsarraySignalements de fraude détectés, ex. mileage_rollback ou salvage_title

checksobjectRésultats par contrôle : rollback_detected, stolen, hidden_damage, title

recorded_mileageobjectDernier kilométrage relevé avec value, unit et cohérence

sources_checkedintegerNombre de sources croisées pour ce scan

metaobjectContexte de la requête, comme le pays scanné (country)

response.json

{

"scan_id": "scn_9d4f12",

"vin": "WBA3A5G59DNP26082",

"scanned_at": "2026-03-12T10:04:00Z",

"risk_score": 78,

"risk_level": "high",

"fraud_flags": ["mileage_rollback", "salvage_title"],

"checks": {

"rollback_detected": true,

"stolen": false,

"hidden_damage": true,

"title": "salvage"

"recorded_mileage": {

"value": 142350,

"unit": "km",

"consistent": false

"sources_checked": 8200,

"meta": { "country": "FR" }

}

Référence

Codes d'erreur

400

Bad Request

Format de VIN invalide ou champs requis manquants

401

Unauthorized

Clé API manquante ou invalide

403

Forbidden

Votre offre n'inclut pas l'accès à la détection de fraude

404

Not Found

Aucun enregistrement trouvé pour scorer la fraude de ce VIN

429

Too Many Requests

Limite de débit dépassée, réessayez après le délai

500

Server Error

Erreur interne, contactez le support si elle persiste

Limites

Limitation de débit

Par minute

300 requêtes

Par jour

10 000 requêtes

Simultanées

20 connexions

Les en-têtes de limite accompagnent chaque réponse : X-Detector-RateLimit-Remaining et X-Detector-RateLimit-Reset.

Prêt à démasquer la fraude à grande échelle ?

Obtenez votre clé API et commencez à scorer la fraude des véhicules en quelques minutes. Environnement bac à sable inclus.

Obtenir une clé API

Bac à sable gratuit. Sans engagement.