API données véhicule : exploiter et vérifier les champs de la réponse
Organisez les données automobile reçues par API : identification, motorisation, caractéristiques et identifiants, avec dictionnaire et exemple JSON.
Publié le
Une API données véhicule renvoie des caractéristiques structurées que votre application peut afficher, comparer ou utiliser pour préparer une fiche. Pour une intégration fiable, distinguez les champs documentés, les valeurs effectivement reçues et les données que votre métier exige avant de poursuivre.
Organiser les champs selon leur usage
Les libellés de marque, modèle et version servent à présenter le véhicule. Les informations de carburant, cylindrée, puissance et puissance fiscale répondent à des questions différentes : elles ne doivent pas être fusionnées dans une seule propriété « moteur ». La date de mise en circulation décrit encore un autre aspect de la fiche.
Le VIN, les références de motorisation et les identifiants de catalogue peuvent soutenir un rapprochement, lorsqu'ils sont disponibles. Leur exploitation demande de connaître le référentiel cible. Consultez le glossaire du VIN et le guide K-Type avant de définir vos clés métier.
Dictionnaire issu du contrat publié
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.
Ce dictionnaire expose les champs de l'exemple fourni avec le produit. Il ne constitue pas une promesse de complétude pour toutes les recherches. La boîte de vitesses est évoquée dans la description générale du produit, mais l'exemple publié ne définit pas de champ correspondant : ne lui attribuez pas un nom de propriété inventé. Le même principe s'applique à toute donnée absente du contrat consultable.
Exemple JSON et contrôles de lecture
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"
}
}Traitez séparément le statut HTTP, les indicateurs de la réponse et la présence d'un objet de données exploitable. Les valeurs numériques représentées sous forme de chaînes doivent être converties explicitement si vous réalisez des calculs. Validez le format d'une date avant de l'enregistrer et n'inférez pas une unité simplement à partir de la valeur.
Préserver la différence entre absence et zéro
Une valeur manquante doit rester inconnue dans votre interface. Ne remplacez pas automatiquement une puissance ou une émission absente par zéro. Si votre formulaire nécessite une information non reçue, demandez-la à l'utilisateur ou passez à une étape de vérification adaptée.
Pour chaque propriété enregistrée, définissez une règle de remplacement : une nouvelle recherche ne devrait pas écraser sans contrôle une correction confirmée par l'utilisateur. La documentation décrit la requête ; les exemples d'intégration permettent ensuite d'implémenter ce contrat dans votre langage.