pratiche consigliate per le interfacce delle versioni WebAPI

Question

mi piacerebbe usare WebAPI come la mia tecnologia API per:

• Consentire aziende autorizzate di inserire/recuperare i dati nel mio systtem
• creare un'interfaccia standard per iOS della mia azienda/Android/etc. applicazioni

Qualcuno conosce le migliori pratiche e i meccanismi utilizzati per implementare il controllo di versione delle interfacce. In particolare, non voglio rompere la compatibilità se faccio aggiornamenti alla mia API. Mi piacerebbe sapere quali sono gli schemi di versioning che le persone usano e se WebAPI ha meccanismi integrati che supportano il controllo delle versioni senza la necessità di impostare percorsi/percorsi ogni volta che viene rilasciata una nuova versione. Ogni pensiero sarebbe apprezzato.

Aggiornamento Dopo aver effettuato alcune ricerche Credo di sapere che cosa voglio fare, non sono sicuro come farlo. Idealmente durante la negoziazione del contenuto mi piacerebbe utilizzare un tipo di media passato dall'utente per specificare quale versione dell'API dovrebbe essere usata (piuttosto che codificare l'URL) e colpire il controller corrispondente.

Answer 1

Se non si desidera includere la versione nell'URL, la strada da percorrere è probabilmente quella di implementare IHttpControllerSelector. Questo post sul blog dovrebbe darti un buon punto di partenza: Implementing API versioning in ASP.NET Web API

Answer 2

Ti consiglio di dare un'occhiata alla serie di post sul blog di Peter Williams allo versioning REST services. Spiegano cosa e perché. Per il come, dai un'occhiata al tutorial di Mike Wasson su how to create a custom media formatter.