Пишу клиент-серверную программу и читаю всякие советы по проектированию REST API.
Есть 2 вида запросов, возвращающих JSON:
http://example.com/calendar/2014/april/1 # день
http://example.com/calendar/2014/april # массив дней
Вопрос в том, что делать с запросами:
http://example.com/calendar/2014
http://example.com/calendar
Приходят в голову варианты:
- Возвращать массив или хеш месяцев и лет.
- Возвращать массив идентификаторов месяцев и лет (без содержимого).
- Возвращать 404.
В статьях советуют первый вариант, но смущает, что:
- Эти запросы не нужны в текущих сценариях.
- Эти запросы будут возвращать большой объем данных.
Как это решают в хороших API?
