Questions fréquentes
Une question qui ne figure pas ici ? Notre équipe vous répond.
Quelles informations l'API renvoie-t-elle à partir d'une plaque ?
Plus de 80 caractéristiques techniques : marque, modèle, version et désignation commerciale, date de première mise en circulation, VIN, énergie, puissances fiscale et réelle, cylindrée, boîte de vitesses, carrosserie, dimensions et poids, émissions de CO₂, code moteur, références K-Type et TecDoc, montes de pneumatiques, logo de la marque et photo du modèle.
L'API fournit-elle des données personnelles sur le propriétaire ?
Non. CKD SIV ne renvoie que des données techniques décrivant le véhicule. Aucune information sur le titulaire de la carte grise (nom, adresse…) n'est accessible.
Combien coûte une requête ?
0,06 € HT par véhicule consulté, sans abonnement ni engagement. Chaque véhicule n'est facturé qu'une seule fois par compte : les consultations suivantes du même véhicule sont gratuites. Les plaques introuvables et les erreurs ne sont jamais facturées.
Comment suis-je facturé ?
La facturation est mensuelle, sur la base des véhicules consultés pour la première fois au cours du mois. Chaque réponse de l'API indique si la requête est facturée et votre consommation du mois ; le détail est consultable et exportable en CSV dans votre espace.
Quels pays et quels formats de plaques sont pris en charge ?
Principalement la France (format SIV AA-123-BC et anciennes plaques FNI), ainsi que l'Espagne, le Royaume-Uni, l'Allemagne, l'Italie, le Portugal et les Pays-Bas. La plaque peut être envoyée avec ou sans tirets ni espaces.
Comment obtenir une clé API ?
Créez votre compte professionnel en quelques minutes (votre entreprise est retrouvée automatiquement grâce à l'annuaire officiel). Après validation de votre compte par notre équipe, vous générez vos clés API depuis votre espace.
Le service est-il réservé aux professionnels ?
Oui. CKD SIV s'adresse aux entreprises disposant d'un SIRET : garages, centres auto, vendeurs de pièces détachées, assureurs, loueurs, gestionnaires de flotte, plateformes automobiles…
Quelles sont les limites d'utilisation ?
Le volume mensuel est illimité. Pour garantir la qualité de service, chaque compte est limité par défaut à 60 requêtes par minute, toutes clés confondues ; cette limite peut être relevée sur demande.
Que se passe-t-il si un véhicule est introuvable ?
L'API renvoie une réponse 404 et la requête n'est pas facturée. Certains véhicules (très anciens, importés récemment, véhicules spéciaux) peuvent ne pas être référencés.
Comment mon compte est-il protégé ?
L'accès à l'espace client est protégé par une double authentification obligatoire (application d'authentification sur votre téléphone) : un mot de passe dérobé ne suffit pas. Les clés API sont stockées sous forme d'empreinte non réversible, révocables à tout moment, et chaque compte dispose d'une limite de débit et de quotas de protection.
Puis-je créer plusieurs clés API ?
Oui, autant que nécessaire (une par application ou par environnement, par exemple). Vous pouvez révoquer une clé à tout moment ; toutes les clés d'un compte partagent la même facturation.
Comment intégrer l'API ?
Il s'agit d'une API REST : un simple appel HTTPS GET avec votre clé dans un en-tête, et une réponse JSON. La documentation fournit des exemples prêts à l'emploi en cURL, PHP, JavaScript et Python.
Vous n'avez pas trouvé votre réponse ?
Contactez-nous