API VIN Decoder internationale

Qu’est-ce qu’une API VIN Decoder ?

Un VIN (Vehicle Identification Number) est le numéro d’identification unique attribué à un véhicule. Il comporte généralement 17 caractères et peut être indiqué sur le certificat d’immatriculation, notamment en case E, ou sur le véhicule.

Notre API VIN Decoder permet aux développeurs et aux professionnels de l’automobile d’utiliser ce numéro pour récupérer une fiche technique structurée : constructeur, modèle, dates du modèle, type de carburant, puissance, nombre de cylindres, transmission et identifiants complémentaires, selon les données disponibles.

Endpoint API VIN Decoder

Les paramètres sont passés dans la chaîne de requête (query string), comme dans la documentation actuelle du service.

POST https://api.apiplaqueimmatriculation.com/vin?vin=VF1DZ0N0641118804&token=VotreToken

Exemple de réponse JSON

Exemple documenté pour le VIN VF1DZ0N0641118804, correspondant à une Renault Mégane III Coupé. Les valeurs représentent l’exemple publié sur la documentation existante et ne constituent pas une requête en temps réel.

{
  "data": {
    "erreur": "",
    "vin": "VF1DZ0N0641118804",
    "marque": "RENAULT",
    "modele": "MEGANE III Coupe (DZ0/1_)",
    "debut_modele": "11-2008",
    "fin_modele": "08-2015",
    "date1erCir": "18-04-2009",
    "variante": "dz0n06",
    "co2": "134",
    "energie": "2",
    "energieNGC": "DIESEL",
    "genreVCG": "1",
    "genreVCGNGC": "VP",
    "puisFisc": "7",
    "carrosserieCG": "COUPE",
    "boite_vitesse": "M",
    "code_boite_vitesse": "",
    "puisFiscReel": "96 KW",
    "nr_passagers": "5",
    "nb_portes": "5",
    "type_mine": "MRE5531A0421",
    "cnit": "MRE5531A0421",
    "couleur": "NOIR",
    "poids": "1807 kg",
    "ccm": "1870 CM3",
    "cylindres": "4",
    "sra_id": "RE80126",
    "sra_group": "32",
    "sra_commercial": "1.9 DCI 130 XV DE FRANCE",
    "numero_serie": "41118804",
    "num_reception": "e2*2001/116*0373*05",
    "ptac": "1807",
    "logo_marque": "https://api.apiplaqueimmatriculation.com/public/storage/logos_marques/?marque=renault",
    "k_type": "31164",
    "tecdoc_manuid": "93",
    "tecdoc_modelid": "7867",
    "tecdoc_carid": "31164",
    "code_moteur": "F9Q_870"
  },
  "api-version": "1.0.0"
}

Référence des champs VIN retournés

Exemples d’intégration de l’API VIN

Exemples pratiques en PHP/Laravel, JavaScript (Node.js), Python et cURL. Utilisez une variable d’environnement pour le token dans les applications en production.

use Illuminate\Support\Facades\Http;

$response = Http::timeout(30)->post(
    'https://api.apiplaqueimmatriculation.com/vin?' . http_build_query([
        'vin' => 'VF1DZ0N0641118804',
        'token' => env('API_PLAQUE_TOKEN'),
    ])
);

$response->throw();
$result = $response->json();
$vehicle = $result['data'] ?? [];

if (empty($vehicle['erreur'])) {
    echo $vehicle['marque'] ?? '';
}

const url = new URL('https://api.apiplaqueimmatriculation.com/vin');
url.search = new URLSearchParams({
  vin: 'VF1DZ0N0641118804',
  token: process.env.API_PLAQUE_TOKEN
});
const response = await fetch(url, { method: 'POST', headers: { Accept: 'application/json' } });
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const result = await response.json();
console.log(result.data);

import os
import requests

response = requests.post(
    'https://api.apiplaqueimmatriculation.com/vin',
    params={
        'vin': 'VF1DZ0N0641118804',
        'token': os.environ['API_PLAQUE_TOKEN']
    },
    headers={'Accept': 'application/json'},
    timeout=30
)
response.raise_for_status()
print(response.json().get('data'))

curl --request POST --get \
  'https://api.apiplaqueimmatriculation.com/vin' \
  --data-urlencode 'vin=VF1DZ0N0641118804' \
  --data-urlencode 'token=VotreToken' \
  --header 'Accept: application/json'

Traitement des erreurs

Traitez séparément les erreurs HTTP/réseau, les réponses JSON incomplètes et les erreurs métier indiquées par data.erreur. Les codes détaillés des erreurs de l’API doivent être confirmés avant d’ajouter un tableau contractuel.

À quoi sert le décodage VIN pour les professionnels ?

Garages et ateliers

Préremplir une fiche véhicule à la réception, limiter la saisie manuelle et identifier les informations mécaniques utiles.

Pièces détachées et e-commerce automobile

Rapprocher un VIN d’un modèle, d’un moteur ou d’un identifiant catalogue. Les identifiants k_type et tecdoc_carid sont indicatifs et ne remplacent pas les contrôles de compatibilité.

Concessionnaires, assurances et gestionnaires de flottes

Uniformiser les données techniques des véhicules et faciliter la qualification des dossiers. L’API n’est pas un service de recherche d’identité du propriétaire ni un certificat officiel d’historique ou de situation administrative.

Questions fréquentes sur le VIN Decoder

Ressources et documentations complémentaires

Pour construire une intégration automobile complète, combinez le décodage VIN avec les autres services et les références techniques ci-dessous.

Liens internes

Sources externes de référence