Immat API — Documentation

Authentification

Utilisez une clé API dans l’en-tête Authorization: Bearer <clé>. Les clés sont gérées depuis votre espace client.

Endpoints

GET /vehicles

Récupère les informations d’un véhicule via sa plaque.

plate (query, requis) – Exemple AB123CD ou AB-123-CD.

Réponse 200 — JSON :

{
  "plate": "AB-123-CD",
  "brand": "Peugeot",
  "model": "208",
  "modelVersion": "Allure",
  "fuel": "Essence",
  "year": 2021,
  "euro": "Euro 6",
  "power_hp": 100,
  "engine_code": "AJGH",
  "fiscal_power": 6,
  "doors": 5,
  "fuel_tank_capacity_l": 44,
  "co2_emission_g_km": 102,
  "has_turbo": true
}

Codes d’erreur

400	Paramètre manquant (ex: `plate` absent)
401	Clé invalide / absente
404	Plaque introuvable
429	Quota dépassé (rate limit)
5xx	Erreur côté serveur

Quotas & limites

Gratuit : 500 requêtes / mois.
Remise à zéro du quota le 1er de chaque mois (UTC).
Réessais recommandés : backoff exponentiel (max 3 tentatives) sur 5xx/429.

Intégration — Exemples multilangages

Bash

curl -s \
  -H "Authorization: Bearer $API_KEY" \
  "https://immat-api.fr/api/vehicles?plate=AB123CD"

Langage