Aller au contenu

Changelog

2026-08-27 — Conversion HTML

Conversion de la documentation depuis Carmoove_API_Car-Sharing_v1.13_FR.pdf (version 1.13, 27/10/2025) vers ce site.

Le code source réel du backend (car-sharing-api, Go) était disponible pour cette API et a été utilisé pour la vérification — une première pour cette conversion, les deux précédentes (Static Data, Dynamic Data) s'appuyant respectivement sur du code consommateur côté client et sur aucune source externe.

Vérifications effectuées :

  • Toutes les routes documentées ont été confrontées à router.go, qui liste l'ensemble des routes réellement enregistrées par l'API.
  • Authentification (v1/login.go) : le flux /v1/login correspond au PDF. En revanche, la réponse de /v1/refreshToken documentée dans le PDF (§4.2) ne liste que token et until — le code source montre qu'elle inclut aussi refresh_token et refresh_until (struct RefreshResponse). Corrigé dans Authentification.
  • Bluetooth-token params/commands (v1/bluetooth.go, §12.1-12.2 du PDF) : documentés comme POST /v1/bluetooth-token/params et POST /v1/bluetooth-token/commands avec authorizationId dans le corps. Les handlers réels ne traitent que la méthode GET, avec authorizationId en paramètre de requête. Corrigé dans Endpoints. Deux codes d'erreur retournés par ces endpoints (AUTHORIZATION_NOT_ACTIVE, AUTHORIZATION_EXPIRED) ne sont documentés nulle part dans le PDF ; ajoutés dans Erreurs.
  • Stationnements (v1/parking.go, §14 du PDF) : les endpoints par identifiant sont documentés au singulier (/v1/parking/{id}) alors que le routeur les enregistre au pluriel (/v1/parkings/{id}). Le champ de réponse de la création est documenté parkingId alors que le JSON réel renvoie parking_id. Les deux corrigés dans Endpoints.
  • Données SIV (§15) : le PDF imprime la route sans séparateur (GET /v1/vehicle/{id}siv) — coquille de mise en page corrigée en /v1/vehicle/{id}/siv, confirmée par le routeur.

Le reste de la surface documentée (véhicules, boîtiers, actions à distance, statuts, listes d'autorisations, réservations) a été vérifié au niveau de l'existence et de la méthode des routes via router.go, mais pas champ par champ dans le code source vu le volume (plus de 60 routes) — au-delà des corrections listées ci-dessus, le contenu suit fidèlement le PDF.

Le tableau de suivi des versions du PDF source (ci-dessous) est complet et cohérent d'une version à l'autre, contrairement à celui de Dynamic Data qui contenait une entrée tronquée.

Historique antérieur (PDF)

Date Version Modification(s)
14/03/2022 0.1 Création du document.
29/03/2022 1.0 1ère version du document.
28/07/2022 1.1 Ajout de la fonction d'archivage d'un véhicule.
06/02/2023 1.2 Ajout de l'identifiant de modèle de boîtier et de la disponibilité des fonctionnalités.
21/04/2023 1.3 Ajout des fonctions spécifiques Bluetooth Teltonika et de la plaque d'immatriculation comme paramètre de certaines fonctions.
13/05/2023 1.4 Ajout de commandes sur les feux et le coffre, de requêtes GET alternatives sans paramètres, et du niveau de carburant dans le statut du véhicule.
20/09/2023 1.5 Ajout de la confidentialité de localisation.
25/03/2024 1.6 Ajout de la liste des véhicules autorisés par utilisateur, de la suppression des autorisations d'un utilisateur, du statut des scénarios configurés sur les boîtiers, et de listes d'autorisation actuelles, expirées et à venir.
18/07/2024 1.7 Ajout des accessoires installés avec le boîtier (détecteur de cartes parking/énergie/autres, détecteur de clé).
27/01/2025 1.8 Ajout de la date du dernier message transmis par le boîtier, de l'état des différents statuts d'un véhicule (remorquage, entretien, panne, vol…), des paramètres offset/limit dans les listes d'autorisations par véhicule, de la liste des trajets d'un véhicule, et de la mise à jour des statuts d'un véhicule.
11/02/2025 1.9 Ajout de la connexion avec un compte utilisateur, de la mise à jour du mot de passe utilisateur, et du point de départ/d'arrivée d'un trajet.
10/03/2025 1.10 Ajout de l'erreur INVALID_PASSWORD_LENGTH pour la mise à jour du mot de passe. Modification de l'ajout de véhicule.
01/04/2025 1.11 Ajout des actions CLOSE-WINDOWS et OPEN-WINDOWS, et des commandes sur les fenêtres.
20/10/2025 1.12 Ajout des fonctions de réservation et des emplacements de stationnement. Ajout des champs energy et bluetoothName dans les informations des véhicules. Ajout des champs encryptReadio et digitalOutput dans les commandes Teltonika.
27/10/2025 1.13 Ajout de données supplémentaires dans la liste des véhicules, des appels pour les réservations et les parkings, et des données SIV d'un véhicule.