Как бы вы разработали SOAP / REST API с коллекцией в качестве входных параметров?

Question

Я разрабатываю веб-сервис wcf, который будет поддерживать интерфейсы REST и SOAP. В качестве методов я смотрю на поддержку следующих типов методов:

GetClientByID(int ID)
GetClientsByID(List<int> ID)

GetClientByEmail(string Email)
GetClientsByEmail(List<string> Email)

Мне также нужно будет поддерживать 15-20 различных запросов, таких как приведенные выше, наличие 4 отдельных запросов означает много методов для поддержки.

Как бы вы разработали подобный API, который должен поддерживать описанный выше случай, когда я могу запросить несколько объектов в одном запросе, а иногда просто запросить один? И в то же время быть SOAP / REST дружественным? Или я слишком усложняю вещи?

Должен ли я сделать все входные списки? вместо того, чтобы иметь отдельный метод GetSingle?

Answer 1

И в то же время быть дружелюбным к SOAP / REST?

Я бы сказал, WS - * / REST friendly. Ничто не мешает вам использовать SOAP в качестве формата ресурса в службе REST.

Хотя я не вижу смысла поддерживать WS- * и REST (но требования - это требования ...), ваше основное приложение должно быть независимым от двух стилей, а затем добавить слой поверх него будет служить адаптером. Один адаптер API для REST и один для WS - *