🔌 API Publique CaleDoVol

⚠️ Cette API n’est pas encore ouverte. L’adresse décrite ci-dessous ne répond pas aujourd’hui (elle renvoie une erreur 404) : la documentation ci-dessous décrit la version prévue, pas un service que vous pouvez appeler maintenant. N’intégrez rien à partir de cette page pour l’instant. En attendant, la vérification d’une plaque se fait à la main sur /verifier.html.

Vérifiez en temps réel si un bien (plaque, IMEI, n° de série) est signalé volé ou perdu en Nouvelle-Calédonie. Prévue gratuite et sans authentification, pensé pour les commerces et ateliers du territoire.

Cas d'usage

🎯 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 ou de bijou
Sites de petites annonces · intégrer un widget de vérification
Plateformes de revente · déclencher une alerte sur les annonces suspectes

Requête

📡 Endpoint

GEThttps://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

📦 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" }

Intégration

💻 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. }

Cadre légal

⚖️ Conditions d'utilisation

Usage gratuit pour les commerces et particuliers en NC
Rate-limit : 1000 requêtes/jour par IP
Aucun stockage de données personnelles côté API
L'API peut signaler des biens « potentiellement volés » sur la base de déclarations communautaires : ce n'est pas une preuve juridique
Intégration à 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, vous pouvez utiliser la recherche web ou nous écrire pour une intégration prioritaire.