# Versionare API pubbliche per client mobile

I client mobile non deployano ogni settimana; ignorarlo rompe la produzione.

Published: 2026-10-19

## Il lag mobile è permanente

Review store e MDM richiedono più generazioni client.

La versione app più vecchia supportata è first-class.

## Versione nel contratto

Epoche esplicite e build identity per richiesta.

Non rimuovere campi senza deprecazione.

- 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

## Coordinare release e supporto

Sunset con upgrade in-app.

Contract test sul bundle più vecchio.

## Misurare lo skew prima del taglio

Dashboard versioni vs epoche.

Evoluzione prevedibile.