# Versionner les API publiques pour clients mobiles

Les clients mobiles ne déploient pas chaque semaine; ignorer cela casse la prod.

Published: 2026-10-19

## Le décalage mobile est permanent

Review store et MDM imposent plusieurs générations clients.

La plus vieille version supportée est un consommateur de premier plan.

## Versionner par contrat

Époques explicites et identité de build par requête.

Pas de retrait de champs sans dépréciation mesurée.

- Publish a mobile compatibility matrix with minimum app versions per API epoch
- Treat breaking changes as contract events with sunset dates in responses
- Run shadow traffic from oldest supported app builds in CI
- Instrument version skew: which app builds hit deprecated fields

## Coordonner release et support

Sunsets avec upgrade in-app.

Tests de contrat sur le plus vieux bundle.

## Mesurer le skew avant coupure

Tableaux de bord versions vs époques.

Évolution prévisible.