Aller au contenu principal
APIPlaque

Réponse JSON API plaque : enveloppe et données véhicule

Lisez le succès HTTP 200 publié et distinguez statut HTTP, enveloppe JSON et champs de données véhicule.

Publié le

La réponse de succès publiée est un objet JSON reçu avec HTTP 200. Elle regroupe le contexte de la recherche, un indicateur d’erreur, un message et un objet data contenant les caractéristiques véhicule.

Exemple publié

Exemple d’intégration côté serveur. Confirmez l’URL et l’en-tête hôte dans votre console RapidAPI avant utilisation.

Requête cURL
# 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
Extrait de la réponse fournie (champs disponibles selon le véhicule)
{
  "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"
  }
}

Lire les différents niveaux

Le statut HTTP décrit la réponse réseau. La propriété JSON code est une valeur du corps ; elle ne remplace pas la lecture du statut HTTP. L’exemple contient aussi country, query, error, message, data et meta.

Contrôlez le décodage JSON, puis l’enveloppe attendue avant d’extraire des champs. Une réponse HTTP réussie ne prouve pas, à elle seule, que les données nécessaires à votre application sont présentes.

Préserver les types

Plusieurs quantités numériques sont représentées par des chaînes dans l’exemple. Conservez leur valeur brute à l’entrée ; ne convertissez un champ que si votre traitement connaît son sens et son format. Les listes d’identifiants ne doivent pas être remplacées arbitrairement par un seul élément.

La date illustrée est une chaîne ; sa forme observée ne garantit pas le format de toutes les réponses. De même, une chaîne "0" ne signifie pas nécessairement qu’une mesure est effectivement nulle.

Données incomplètes

L’exemple n’établit ni un schéma exhaustif, ni la nullabilité, ni la présence garantie de chaque champ. Utilisez des états « indisponible » adaptés dans votre interface et validez les champs nécessaires à une décision métier.

Consultez le dictionnaire des champs, les erreurs non documentées et les exemples par langage.