Versionierung öffentlicher APIs für Mobile Clients

Mobile Verzögerung ist dauerhaft

App Store und MDM bedeuten mehrere Client-Generationen parallel.

Älteste unterstützte App-Version ist First-Class.

Version in Verträgen

Explizite API-Epochen und Build-Identität pro Request.

Felder nicht ohne Deprecation entfernen.

• 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

Mit Release und Support koordinieren

Sunsets mit In-App-Upgrade koppeln.

Contract-Tests auf ältestem Bundle.

Skew messen vor Cut

Dashboard Versionen vs Epochen.

Vorhersagbare Evolution statt Chaos.

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