🔌 API Publique CaleDoVol

Vérifie en temps réel si un bien (plaque, IMEI, n° série) est signalé volé/perdu en NC. Gratuit, sans authentification, pour les commerces et ateliers de NC.

🎯 Pour qui ?

Magasins de rachat / occasions : vérifier l'IMEI d'un téléphone avant achat
Ateliers auto / 2-roues : vérifier la plaque ou le VIN d'un véhicule
Bijouteries : checker un n° de série de montre/bijou
Sites de petites annonces : intégrer un widget de vérification
Plateformes de revente : déclencher une alerte sur les annonces suspectes

📡 Endpoint

GET https://caledovol.com/api/check?type=plaque&value=345678

Paramètres :

type (requis) : plaque · imei · puce · numSerie
value (requis) : la valeur à vérifier (insensible à la casse, sans espaces)

📦 Réponse JSON

{ "flagged": true, "matches": [ { "id": "abc123", "kind": "vole", "category": "vehicule", "date": "2026-04-12", "commune": "Nouméa", "url": "https://caledovol.com/fiche.html?id=abc123" } ], "checkedAt": "2026-04-26T10:30:00Z" }

💻 Exemples d'intégration

JavaScript

fetch('https://caledovol.com/api/check?type=imei&value=' + imei) .then(r => r.json()) .then(d => { if (d.flagged) alert('⚠️ Ce téléphone est signalé volé ! Voir : ' + d.matches[0].url); });

PHP / WooCommerce

$resp = file_get_contents("https://caledovol.com/api/check?type=plaque&value=" . urlencode($plate)); $data = json_decode($resp, true); if ($data['flagged']) { // bloquer la vente, alerter l'admin, etc. }

⚖️ Conditions d'utilisation

Usage gratuit pour les commerces et particuliers en NC
Rate-limit : 1000 requêtes/jour par IP
Pas de stockage de données personnelles côté API
L'API peut signaler des biens "potentiellement volés" basés sur les déclarations communautaires : ce n'est pas une preuve juridique
Pour des intégrations à fort volume ou besoin spécifique : contact@caledohub.com

📢 Bientôt disponible

L'endpoint API est en cours de déploiement (Cloud Function). En attendant, tu peux utiliser la recherche web ou nous écrire pour une intégration prioritaire.