L’API possède deux types de versions : les majeures et les mineures. Les versions majeures sont indiquées dans le chemin des URLs `.../vX/...`.

Lorsque des modifications, qui ne sont pas rétrocompatibles, sont apportées à l’API, une nouvelle version majeure est créée et l’ancienne est dépréciée. Les deux versions seront disponibles le temps que les développeurs migrent leur code vers la nouvelle version.

Les versions mineures, de leur côté, sont rétrocompatibles et apportent des modifications à l’API grâce aux retours des développeurs.

Ce journal des changements fourni les informations sur les versions majeures de l'API et leurs évolutions.

## Changements du 29/05/2013
### API stations v1
*  Ajout du champ `contract_name` dans les stations, il représente le contrat d'appartenance de la station
*  Le paramètre `contract` lors de l'interrogation des stations n'est plus sensible à la casse
*  Ajout du champ `country_code` dans les contrats, il représente le code (ISO 3166) du pays

## Changements du 09/08/2018
### API stations v2
*  Renommage des attributs de station `lat` et `lng` en `latitude` et `longitude`
*  L'attribut de station `last_update` est dorénavant au format Javascript (ISO 8601)
*  Ajout des attributs station suivants : 
   *   `connected`, boolean vrai lorsque la station est connectée au système central
   *   `overflow`, boolean vrai lorsque la station accepte la repose de vélo en overflow
   *   `overflow_bike_stands`, entier indiquant le nombre de places disponibles en overflow
   *   `overflow_bikes`, entier indiquant le nombre de vélos disponibles en overflow
   *   `shape`, usage future, non utilisé pour l'instant

### API parks v1
*  Ajout de la ressource `parks` (contrat Nantes uniquement), permet d'interroger les informations de localisation des parkings à vélos

## Changements du 08/04/2019
### API stations v3
*  Renommage de l'attribut de station `contract_name` en `contractName`
*  Renommage de l'attribut de station `last_update` en `lastUpdate`
*  Refonte des information de comptage dans 3 sous-objets `totalStands`, `mainStands` et `overflowStands`
*  Ajout du détail de comptage par type de vélo (mécanique, vae, avec batterie embarquée ou amovible)