Versionare API pubbliche per client mobile

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.

• Stripe — API versioning
• Microsoft — REST API guidelines
• Apple — App Store review guidelines