Comment intégrer l'API plaque immatriculation dans mon application métier

Guide pratique pour intégrer l'API Plaque Immatriculation France dans une application métier. Exemples en curl, Node.js, Python et PHP, bonnes pratiques et cas d'usage.

Publié le 9 septembre 2026API Plaque

L'identification automatique d'un véhicule à partir de sa plaque d'immatriculation est devenue un levier simple et efficace pour de nombreuses applications métier : garages, plateformes de pièces détachées, assureurs, gestionnaires de flotte ou encore services de carte grise. Cet article explique comment intégrer l'API Plaque Immatriculation France – Données Véhicule SIV dans votre application, de l'inscription à la première requête.

Ce que fournit l'API

L'API expose un seul endpoint GET /fr qui retourne les informations techniques et d'identification d'un véhicule immatriculé en France à partir de son numéro de plaque.

Parmi les champs disponibles dans la réponse, on trouve notamment :

La marque, le modèle et la version
Le VIN
La date de première mise en circulation
Le type de carburant
La puissance en kW et en chevaux
La cylindrée
Les émissions de CO₂
Le genre du véhicule

Ces données permettent d'alimenter un formulaire, de vérifier une saisie ou d'enrichir une fiche véhicule sans saisie manuelle.

Prérequis

Un compte RapidAPI. L'API est distribuée via RapidAPI, vous devez donc disposer d'un compte pour obtenir une clé d'API.
Une souscription à l'API. Un plan gratuit est généralement disponible pour les tests, puis des plans Pro, Ultra et Mega selon le volume d'appels.
Un numéro de plaque d'immatriculation français valide à tester.

Une fois connecté à RapidAPI, récupérez votre clé API dans la section API Keys de votre espace développeur.

Format de la requête

Le endpoint accepte un unique paramètre de requête obligatoire :

| Paramètre | Type | Obligatoire | Description | | --------- | ------ | ----------- | ------------------------------------- | | plaque | string | oui | Numéro d'immatriculation du véhicule |

L'URL de base de l'API est :

https://api-plaque-immatriculation-france-donnees-vehicule-siv.p.rapidapi.co

L'URL complète pour interroger une plaque ressemble donc à :

GET https://api-plaque-immatriculation-france-donnees-vehicule-siv.p.rapidapi.co/fr?plaque=FH034DD

Authentification

Chaque requête doit inclure deux en-têtes HTTP :

x-rapidapi-key : votre clé API RapidAPI
x-rapidapi-host : le host de l'API

x-rapidapi-key: VOTRE_CLE_RAPIDAPI
x-rapidapi-host: https://api-plaque-immatriculation-france-donnees-vehicule-siv.p.rapidapi.co

Exemples d'intégration

Avec curl

La façon la plus rapide de tester l'API est d'utiliser curl :

curl -G \
  "https://api-plaque-immatriculation-france-donnees-vehicule-siv.p.rapidapi.co/fr" \
  -H "x-rapidapi-key: VOTRE_CLE_RAPIDAPI" \
  -H "x-rapidapi-host: https://api-plaque-immatriculation-france-donnees-vehicule-siv.p.rapidapi.co" \
  -d "plaque=FH034DD"

Avec Node.js / JavaScript

const API_URL = "https://api-plaque-immatriculation-france-donnees-vehicule-siv.p.rapidapi.co/fr";
const API_KEY = process.env.RAPIDAPI_KEY;

async function getVehicleData(plate) {
  const url = new URL(API_URL);
  url.searchParams.set("plaque", plate);

  const response = await fetch(url, {
    headers: {
      "x-rapidapi-key": API_KEY,
      "x-rapidapi-host": "https://api-plaque-immatriculation-france-donnees-vehicule-siv.p.rapidapi.co",
    },
  });

  if (!response.ok) {
    throw new Error(`HTTP ${response.status}`);
  }

  return response.json();
}

getVehicleData("FH034DD")
  .then((data) => console.log(data.data.AWN_marque, data.data.AWN_modele))
  .catch((error) => console.error(error));

Avec Python

import os
import requests

API_URL = "https://api-plaque-immatriculation-france-donnees-vehicule-siv.p.rapidapi.co/fr"
API_KEY = os.environ["RAPIDAPI_KEY"]

headers = {
    "x-rapidapi-key": API_KEY,
    "x-rapidapi-host": "https://api-plaque-immatriculation-france-donnees-vehicule-siv.p.rapidapi.co",
}

params = {"plaque": "FH034DD"}

response = requests.get(API_URL, headers=headers, params=params)
response.raise_for_status()
data = response.json()

print(data["data"]["AWN_marque"], data["data"]["AWN_modele"])

Avec PHP

<?php
$plate = "FH034DD";
$apiKey = getenv("RAPIDAPI_KEY");
$host = "https://api-plaque-immatriculation-france-donnees-vehicule-siv.p.rapidapi.co";

$ch = curl_init("{$host}/fr?plaque=" . urlencode($plate));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-rapidapi-key: {$apiKey}",
    "x-rapidapi-host: {$host}",
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo $data["data"]["AWN_marque"] . " " . $data["data"]["AWN_modele"];

Structure de la réponse

La réponse JSON contient une racine avec les champs suivants :

code : le code HTTP de la réponse
country : le pays du véhicule, ici FR
query : la plaque demandée
error : booléen indiquant si une erreur s'est produite
message : message de statut
data : objet contenant les informations du véhicule
meta : métadonnées sur la version de l'API

Voici un extrait typique de l'objet data :

{
  "AWN_marque": "RENAULT",
  "AWN_modele": "CLIO",
  "AWN_version": "1.5 dCi 90",
  "AWN_VIN": "VF1R9800962986572",
  "AWN_date_mise_en_circulation": "20-06-2019",
  "AWN_energie": "GAZOLE",
  "AWN_puissance_chevaux": "90",
  "AWN_puissance_KW": "66",
  "AWN_cylindree_liters": "1.5",
  "AWN_emission_co_2": "104"
}

Attention : la liste exacte des champs retournés dépend des informations disponibles pour le véhicule interrogé. Ne partez pas du principe qu'un champ sera toujours présent sans le vérifier dans votre code.

Bonnes pratiques d'intégration

1. Stockez votre clé API en dehors du code source

Utilisez une variable d'environnement ou un coffre-fort de secrets. Ne commitez jamais votre clé API dans un dépôt public.

2. Validez la plaque avant l'appel

Avant d'appeler l'API, nettoyez la plaque :

supprimez les espaces et les tirets
passez en majuscules
vérifiez que la longueur est cohérente avec le format SIV (7 caractères alphanumériques pour les plaques actuelles)

Cela réduit le nombre d'appels inutiles et améliore les performances.

3. Gérez les erreurs de manière explicite

Prévoyez au minimum trois cas :

erreur réseau ou HTTP non 200
réponse avec error: true
absence d'un champ attendu dans data

4. Mettez en cache les résultats

Un numéro d'immatriculation ne change pas au fil du temps. Si votre application consulte fréquemment les mêmes plaques, stockez le résultat dans une base de données ou un cache (Redis, par exemple) pour limiter les appels facturés.

5. Journalisez les appels

Pour le debugging et le suivi de consommation, gardez une trace des appels effectués : timestamp, plaque demandée, code de réponse, volume de données retourné. Évitez de logger le VIN ou d'autres données sensibles en production si cela n'est pas nécessaire.

Cas d'usage métier

L'API s'intègre naturellement dans plusieurs secteurs :

Garages et centres auto : création automatique de fiches véhicule à la prise de rendez-vous
Vendeurs de pièces détachées : suggestion de pièces compatibles selon modèle, moteur et année
Assurances : pré-remplissage d'un devis à partir d'une plaque
Gestion de flotte : inventaire et suivi technique des véhicules
Plateformes de carte grise : vérification des informations avant dépôt d'une démarche
Comparateurs et places de marché automobile : enrichissement des annonces avec les données retournées par l’API

Conclusion

Intégrer l'API Plaque Immatriculation France dans une application métier est un processus rapide : une requête GET, un paramètre plaque, et quelques en-têtes d'authentification suffisent à récupérer des données techniques détaillées. En suivant les bonnes pratiques ci-dessus — validation, gestion d'erreur, cache et sécurisation de la clé — vous obtiendrez une intégration fiable et évolutive.

Pour commencer, souscrivez à l'API sur RapidAPI, récupérez votre clé et testez votre première plaque avec l'exemple curl proposé dans cet article.