Лучшие практики для выпуска клиента версии API
У меня есть версионный API для NemeStats.com, задокументированный на Apiary.io здесь: http://docs.nemestatsapiversion2.apiary.io/
Я собираюсь выпустить клиентскую библиотеку классов C# API (на GitHub и NuGet), но пытаюсь выяснить, что было бы наилучшим решением для версии API. Некоторые вещи, которые я рассматриваю:
- Выпустите новый клиент API с версией, четко обозначенной в названии. Например, NemeStatsApiVersion1Client против NemeStatsApiVersion2Client
- Оставьте тот же клиент, но добавьте альтернативные методы версии для каждого вызова API. Например, "usersClient.RegisterNewUserV1()" против "usersClient.RegisterNewUserV2()" и т. Д.
- Держите одного и того же клиента, но просто имейте разные версии классов (ресурсов). Например, "UsersClientV1" против "UsersClientV2".
Кто-нибудь делал это раньше? Какие-нибудь советы?