Documentation technique : lire une plaque minéralogique via API

curl --request GET \
  --url 'https://api-de-plaque-d-immatriculation-france.p.rapidapi.com/?plaque=FH-034-DD' \
  --header 'Content-Type: application/json' \
  --header 'x-rapidapi-host: api-de-plaque-d-immatriculation-france.p.rapidapi.com' \
  --header 'x-rapidapi-key: VOTRE_CLE_API'

const SIV = /^[A-Z]{2}[0-9]{3}[A-Z]{2}$/;
const FNI = /^[0-9]{1,4}[A-Z]{2,3}[0-9]{2}$/;
 
const normaliser = (s) => s.toUpperCase().replace(/[\s-]/g, "");
const valide = (s) => SIV.test(normaliser(s)) || FNI.test(normaliser(s));

{
  "error": false,
  "code": 200,
  "message": "Succès",
  "query": "FH-034-DD",
  "country": "FR",
  "data": { }
}

async function interrogerPlaque(plaque) {
  const res = await fetch(
    `https://api-de-plaque-d-immatriculation-france.p.rapidapi.com/?plaque=${plaque}`,
    {
      headers: {
        "x-rapidapi-key": process.env.RAPIDAPI_KEY,
        "x-rapidapi-host": "api-de-plaque-d-immatriculation-france.p.rapidapi.com",
      },
      signal: AbortSignal.timeout(8000),
    },
  );
 
  switch (res.status) {
    case 200:
      break;
    case 400:
      throw new Error("FORMAT_INVALIDE");
    case 401:
      throw new Error("AUTH");
    case 404:
      throw new Error("INTROUVABLE");
    case 429:
      throw new Error("QUOTA");
    default:
      throw new Error("INDISPONIBLE");
  }
 
  const json = await res.json();
  if (json.error) throw new Error(json.message);
  return json.data;
}

const plaque = "FH034DD";
 
const res = await fetch(
  `https://api-de-plaque-d-immatriculation-france.p.rapidapi.com/?plaque=${plaque}`,
  {
    headers: {
      "Content-Type": "application/json",
      "x-rapidapi-key": process.env.RAPIDAPI_KEY,
      "x-rapidapi-host": "api-de-plaque-d-immatriculation-france.p.rapidapi.com",
    },
  },
);
 
const json = await res.json();
const v = json.data;
 
const propre = (val) => (val && val !== "INCONNU" ? val : null);
 
console.log({
  marque: propre(v.marque),
  modele: propre(v.modele),
  energie: propre(v.energie),
  chevaux: Number(v.puissance_chevaux) || null,
  co2: Number(v.emission_co_2) || null,
});

import os
import requests
 
BASE = "https://api-de-plaque-d-immatriculation-france.p.rapidapi.com/"
 
 
def propre(valeur):
    return None if valeur in (None, "", "INCONNU") else valeur
 
 
def interroger_plaque(plaque: str) -> dict:
    plaque = plaque.upper().replace("-", "").replace(" ", "")
    reponse = requests.get(
        BASE,
        params={"plaque": plaque},
        headers={
            "Content-Type": "application/json",
            "x-rapidapi-key": os.environ["RAPIDAPI_KEY"],
            "x-rapidapi-host": "api-de-plaque-d-immatriculation-france.p.rapidapi.com",
        },
        timeout=10,
    )
 
    if reponse.status_code == 404:
        raise LookupError("Véhicule introuvable")
    if reponse.status_code == 429:
        raise RuntimeError("Quota dépassé")
    reponse.raise_for_status()
 
    charge = reponse.json()
    if charge.get("error"):
        raise RuntimeError(charge.get("message", "Erreur inconnue"))
 
    data = charge["data"]
    return {
        "marque": propre(data.get("marque")),
        "modele": propre(data.get("modele")),
        "energie": propre(data.get("energie")),
        "chevaux": int(data["puissance_chevaux"]) if propre(data.get("puissance_chevaux")) else None,
        "co2": int(data["emission_co_2"]) if propre(data.get("emission_co_2")) else None,
    }
 
 
print(interroger_plaque("FH-034-DD"))

<?php
$plaque = strtoupper(str_replace(['-', ' '], '', 'FH-034-DD'));
$url = 'https://api-de-plaque-d-immatriculation-france.p.rapidapi.com/?plaque=' . urlencode($plaque);
 
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'x-rapidapi-key: ' . getenv('RAPIDAPI_KEY'),
        'x-rapidapi-host: api-de-plaque-d-immatriculation-france.p.rapidapi.com',
    ],
]);
 
$corps = curl_exec($ch);
$statut = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
 
if ($statut !== 200) {
    throw new RuntimeException("Requête échouée (HTTP $statut)");
}
 
$charge = json_decode($corps, true);
if (!empty($charge['error'])) {
    throw new RuntimeException($charge['message']);
}
 
$v = $charge['data'];
$propre = fn ($val) => ($val && $val !== 'INCONNU') ? $val : null;
 
printf("%s %s — %s\n", $propre($v['marque']), $propre($v['modele']), $propre($v['energie']));