API plaque immatriculation : identifier un véhicule dans votre application
Intégrez une recherche par plaque française dans votre logiciel : données véhicule, exemple de réponse et parcours de validation avant utilisation.
Publié le
Une API plaque immatriculation permet à une application de demander les caractéristiques d'un véhicule à partir de sa plaque française. Elle sert à amorcer une fiche véhicule dans un logiciel métier, un formulaire ou un parcours de sélection, puis à présenter les informations obtenues à l'utilisateur pour validation.
De la saisie de plaque à une fiche exploitable
Le parcours commence par un champ de saisie dans votre application. Votre serveur effectue la requête authentifiée, examine la réponse, puis transmet à l'interface les seules informations nécessaires. L'utilisateur peut ainsi confirmer le véhicule proposé avant de poursuivre son devis, sa commande ou son dossier.
Cette étape de confirmation compte autant que la recherche : une plaque mal saisie ou une variante ambiguë ne doit pas créer automatiquement une fiche définitive. Prévoyez également une sélection manuelle lorsque la recherche ne donne pas les renseignements attendus.
Quelles données intégrer ?
La présentation des données véhicule aide à distinguer les libellés destinés à l'affichage et les identifiants utiles à vos rapprochements. Les champs effectivement documentés figurent dans le dictionnaire ci-dessous. Leur présence dans un exemple ne garantit pas une valeur pour chaque véhicule.
Types observés dans une réponse de démonstration, sans garantie de présence pour tous les véhicules. Les champs numériques sont souvent des chaînes. Les unités non documentées restent à confirmer auprès du fournisseur.
- AWN_KBA
Identifiant KBA présent dans cet exemple
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"3333AZY"Présence et nullabilité non garanties par l’exemple.
- AWN_KBAS
Liste des identifiants KBA observés
Type observé :
array. Unité : Non spécifiée dans le contrat fourni.Exemple :
["3333AZY"]Présence et nullabilité non garanties par l’exemple.
- AWN_PTAC
Poids total autorisé en charge
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"1700"Présence et nullabilité non garanties par l’exemple.
- AWN_VIN
Numéro d’identification du véhicule (VIN)
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"VF1R9800962986572"Présence et nullabilité non garanties par l’exemple.
- AWN_annee_de_debut_modele
Début de la période du modèle
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"2012"Présence et nullabilité non garanties par l’exemple.
- AWN_annee_de_fin_modele
Fin de la période du modèle
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"Aujourd'hui"Présence et nullabilité non garanties par l’exemple.
- AWN_capacite_reservoir
Capacité du réservoir
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"0"Présence et nullabilité non garanties par l’exemple.
- AWN_code_moteur
Référence du moteur
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"K9K_638"Présence et nullabilité non garanties par l’exemple.
- AWN_code_platform
Code de plateforme
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"BH"Présence et nullabilité non garanties par l’exemple.
- AWN_codes_moteur
Liste des codes moteur associés
Type observé :
array. Unité : Non spécifiée dans le contrat fourni.Exemple :
["K9K_638","K9K_608","K9K_628"]Présence et nullabilité non garanties par l’exemple.
- AWN_cylindre_capacite
Cylindrée
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"1461"Présence et nullabilité non garanties par l’exemple.
- AWN_cylindree_liters
Cylindrée exprimée en litres d’après le nom du champ
Type observé :
string. Unité : L (nom du champ).Exemple :
"1.5"Présence et nullabilité non garanties par l’exemple.
- AWN_date_mise_en_circulation
Date de mise en circulation
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"20-06-2019"Présence et nullabilité non garanties par l’exemple.
- AWN_emission_co_2
Émissions de CO₂
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"104"Présence et nullabilité non garanties par l’exemple.
- AWN_energie
Carburant ou énergie
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"GAZOLE"Présence et nullabilité non garanties par l’exemple.
- AWN_energie_code
Code énergie du fournisseur
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"1"Présence et nullabilité non garanties par l’exemple.
- AWN_energie_description
Libellé de l’énergie
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"GAZOLE"Présence et nullabilité non garanties par l’exemple.
- AWN_generation
Identifiant de génération
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"0"Présence et nullabilité non garanties par l’exemple.
- AWN_genre
Genre du véhicule
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"VP"Présence et nullabilité non garanties par l’exemple.
- AWN_genre_code
Code du genre
Type observé :
number. Unité : Non spécifiée dans le contrat fourni.Exemple :
1Présence et nullabilité non garanties par l’exemple.
- AWN_immat
Immatriculation
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"FH034DD"Présence et nullabilité non garanties par l’exemple.
- AWN_k_type
Identifiant de type véhicule K-Type
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"57281"Présence et nullabilité non garanties par l’exemple.
- AWN_k_types
Liste de K-Type associés
Type observé :
array. Unité : Non spécifiée dans le contrat fourni.Exemple :
["57281"]Présence et nullabilité non garanties par l’exemple.
- AWN_label
Désignation du véhicule
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"RENAULT CLIO 1.5 dCi 90"Présence et nullabilité non garanties par l’exemple.
- AWN_label_moteur
Désignation de la motorisation
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"1.5 dCi 90"Présence et nullabilité non garanties par l’exemple.
- AWN_marque
Marque
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"RENAULT"Présence et nullabilité non garanties par l’exemple.
- AWN_marque_image
URL d’illustration de la marque
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"https://api.auto-ways.net/images/brands/RENAULT"Présence et nullabilité non garanties par l’exemple.
- AWN_model_image
URL d’illustration du modèle
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"https://api.auto-ways.net/images/car-models/57281"Présence et nullabilité non garanties par l’exemple.
- AWN_modele
Modèle
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"CLIO"Présence et nullabilité non garanties par l’exemple.
- AWN_modele_etude
Désignation du modèle dans la source
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"CLIO"Présence et nullabilité non garanties par l’exemple.
- AWN_modele_prf
Autre désignation du modèle dans la source
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"CLIO"Présence et nullabilité non garanties par l’exemple.
- AWN_nbr_cylindre_energie
Champ fournisseur dont la signification n’est pas confirmée
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"1461"Présence et nullabilité non garanties par l’exemple.
- AWN_puissance_KW
Puissance en kW d’après le nom du champ
Type observé :
string. Unité : kW (nom du champ).Exemple :
"66"Présence et nullabilité non garanties par l’exemple.
- AWN_puissance_chevaux
Puissance en chevaux d’après le nom du champ
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"90"Présence et nullabilité non garanties par l’exemple.
- AWN_puissance_fiscale
Puissance fiscale
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"5"Présence et nullabilité non garanties par l’exemple.
- AWN_selector_modele_label
Désignation pour la sélection du modèle
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"Renault Clio IV (BH), 1461 cm³, 90 CV (66 kW), à partir de 11/2012"Présence et nullabilité non garanties par l’exemple.
- AWN_style_carrosserie
Carrosserie
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"3/5 portes"Présence et nullabilité non garanties par l’exemple.
- AWN_tecdoc_modele_description
Description du modèle issue du champ TecDoc
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"Renault Clio IV (BH), 1461 cm³, 90 CV (66 kW), à partir de 11/2012"Présence et nullabilité non garanties par l’exemple.
- AWN_version
Version
Type observé :
string. Unité : Non spécifiée dans le contrat fourni.Exemple :
"1.5 dCi 90"Présence et nullabilité non garanties par l’exemple.
Exemple de requête et de réponse
Cet exemple illustre le contrat publié. Exécutez les appels authentifiés côté serveur et consultez la documentation pour préparer l'intégration dans votre environnement.
Exemple d’intégration côté serveur. Confirmez l’URL et l’en-tête hôte dans votre console RapidAPI avant utilisation.
# Configuration serveur uniquement. Confirmer URL et hôte dans RapidAPI.
RAPIDAPI_KEY=YOUR_RAPIDAPI_KEY
API_PLAQUE_BASE_URL=https://api-plaque-immatriculation-france-donnees-vehicule-siv.p.rapidapi.co
RAPIDAPI_HOST=api-plaque-immatriculation-france-donnees-vehicule-siv.p.rapidapi.co{
"code": 200,
"country": "FR",
"error": false,
"data": {
"AWN_marque": "RENAULT",
"AWN_modele": "CLIO",
"AWN_version": "1.5 dCi 90",
"AWN_energie": "GAZOLE",
"AWN_puissance_KW": "66",
"AWN_puissance_fiscale": "5",
"AWN_code_moteur": "K9K_638",
"AWN_k_type": "57281"
}
}Choisir un premier parcours à automatiser
Dans un garage, commencez par la création d'une fiche atelier. Dans un site de pièces, commencez par le sélecteur de véhicule. Mesurez ensuite les fiches confirmées, les corrections et les recherches sans résultat exploitable, plutôt que de considérer toute réponse reçue comme une identification validée.
Questions fréquentes
Faut-il remplacer la saisie manuelle ?
Conservez-la comme solution de repli. L'API facilite l'identification ; votre application reste responsable de la validation du parcours et des informations nécessaires à sa finalité.
Comment estimer mon volume de requêtes ?
Comptez les recherches déclenchées par une action explicite de l'utilisateur. Évitez un appel à chaque caractère et consultez les formules disponibles avant de dimensionner votre parcours.
Où commencer techniquement ?
Le catalogue de l'API présente l'endpoint et la documentation d'intégration détaille son utilisation. Testez d'abord une requête depuis votre serveur, puis ajoutez la confirmation et le traitement des échecs.