Aller au contenu

Changelog

2026-08-27 — Vérification approfondie contre le backend réel

Le vrai backend de cette API a été identifié — carmoove-backend/customer-services/data-api (repo Go, cloné en lecture seule via SSH ; son unique route métier, GET /v1/siv/fr/{search}, et sa réponse GetVehicleSIVFRResponse correspondent exactement à cette doc) — et son code source lu intégralement (v1/vehicle.go), en plus de la vérification côté client faite lors de la conversion initiale. Cette lecture, plus exhaustive que le client-side check, a mis en évidence des écarts que celui-ci n'avait pas couverts :

  • Casse de champs dans l'objet certificate : VIN → vin, Displacement → displacement (les deux en minuscule dans le JSON réel).
  • Nom de champ dans l'objet certificate : unload_weight → unloaded_weight.
  • Codes d'erreur manquants : en plus de UNKNOWN_VEHICLE, l'endpoint peut renvoyer INVALID_VEHICLE, INVALID_VIN_CODE (VIN de 17 caractères au format invalide) et INVALID_PLATE (plaque ne correspondant à aucun format SIV/FNI connu) — absents du PDF et non ajoutés lors de la première conversion. Ajoutés à Erreurs.
  • Point d'attention non résolu : dans le code lu, les quatre cas d'erreur ci-dessus renvoient la réponse via json.NewEncoder(w).Encode(...) sans appeler explicitivement w.WriteHeader(480) au préalable — ce qui, en Go, produit par défaut un statut HTTP 200 plutôt que le 480 documenté dans ce site (voir Codes HTTP). Un composant en amont (proxy/gateway) pourrait réécrire ce statut avant qu'il n'atteigne le client ; en l'absence de moyen de le vérifier en conditions réelles, la convention 480 déjà documentée est conservée telle quelle, mais ce point mérite d'être confirmé auprès de l'équipe backend avant de faire confiance aveuglément au code HTTP retourné par cet endpoint.

Champs des objets additional_information, fluids, electric et tires : tous confirmés identiques au JSON réel, aucune correction nécessaire.

2026-08-27 — Conversion HTML

Conversion de la documentation depuis Carmoove_API_Static-Data_v1.4_FR.pdf (version 1.4, 25/11/2024) vers ce site.

Le contenu (authentification, endpoint GET /v1/siv/fr/{plate_or_vin}, forme de la réponse et champs des objets certificate, additional_information, fluids, electric, tires) a été vérifié par rapport à l'implémentation réelle côté extranet (extranet/backend/src/lib/static-data-client.ts) et au post-mortem d'intégration SIV — aucun écart constaté entre le PDF v1.4 et le comportement réel de l'API à ce niveau de vérification (voir l'entrée plus récente ci-dessus pour la vérification côté backend, plus exhaustive).

Historique antérieur (PDF)

Date Version Modification(s)
04/06/2024 0.1 Création du document.
06/06/2024 1.0 1ère version du document.
07/06/2024 1.1 Ajout des données des véhicules électriques.
10/06/2024 1.2 Relecture, correction et formatage.
13/06/2024 1.3 Ajout de données supplémentaires et pneus.
25/11/2024 1.4 Correction de certains noms de champs.