Zalecane praktyki dla interfejsów Versioning WebAPI

Question

Chciałbym użyć WebAPI jak mój technologii API do:

• Pozwól zatwierdzone firmom wejść/pobierania danych w moim systtem
• Utwórz standardowy interfejs dla iOS mojej firmy/Android/itd. aplikacje

Czy ktoś wie o najlepszych praktykach i mechanizmach do implementacji, wersjonowaniu interfejsów. W szczególności nie chcę łamać wstecz, jeśli aktualizuję mój interfejs API. Chciałbym wiedzieć, jakich schematów wersjonowania używają ludzie, a jeśli WebAPI ma wbudowane mechanizmy wspierające wersjonowanie bez potrzeby konfigurowania tras/ścieżek za każdym razem, gdy zostanie wydana nowa wersja. Wszelkie przemyślenia będą mile widziane.

Aktualizacja Po przeprowadzeniu badań uważam, że wiem, co chcę zrobić, nie jestem pewien, jak to zrobić. Idealnie podczas negocjacji treści chciałbym użyć typu mediów przekazanego przez użytkownika, aby określić, która wersja API powinna być używana (zamiast twardego kodowania adresu URL) i trafić odpowiedni kontroler.

Answer 1

Jeśli nie chcesz, aby wersja była dołączona do adresu URL, najprawdopodobniej należy uruchomić narzędzie IHttpControllerSelector. Ten wpis na blogu powinien dać dobry punkt wyjścia: Implementing API versioning in ASP.NET Web API

Answer 2

Polecam zapoznać się z serią postów na blogu Petera Williamsa pod numerem versioning REST services. Wyjaśniają, co i dlaczego. Aby dowiedzieć się, jak to zrobić, zapoznaj się z samouczkiem Mike'a Wassona pod numerem how to create a custom media formatter.