RESTful API и страница статистики - PullRequest
0 голосов
/ 07 февраля 2020

У меня есть RESTful API, который управляет клиентами и платежами.

Мне было предложено создать страницу статистики с такими данными, как:

  • общее количество клиентов
  • сколько клиентов активно / неактивно
  • общее количество платежей
  • сколько платежей не удалось / были успешными
  • сколько платежей не удалось / были успешными в день
  • сколько платежей не удалось / было успешно выполнено в месяц
  • сколько денег было заработано в день
  • сколько денег было заработано в месяц
  • и другие

У меня есть конечные точки для всего, и я могу получить клиентов, позвонив по номеру api/customers, а платежи - по номеру api/payments. Я знаю, что могу позвонить api/payments?status=successful и api/payments?status=failed, чтобы получить нужные мне данные, однако система имеет сотни платежей и тысячи клиентов, и для обработки каждого запроса требуется время. Кроме того, я знаю, что могу получить всю статистику платежей одним запросом с оператором group by.

Мой вопрос: нарушит ли это соглашение RESTful для создания новой конечной точки для каждой требуемой статистики? Это позволило бы мне создавать «оптимизированные» запросы для каждого показателя c.

Заранее спасибо

Ответы [ 2 ]

1 голос
/ 07 февраля 2020

RESTful - это просто архитектурный стиль для ваших API. Если вы прочитаете RF C, вы обнаружите, что ни один из RESTful API действительно не является RESTful. Существует огромное количество предложений для того, чтобы на самом деле реализовать такой API.

Мое мнение (и ответ) на ваш вопрос заключается в том, что такая архитектура больше похожа на руководство по структурированию вашего API, чем строгое следование ему. , Разработка программного обеспечения - это принятие таких решений, идеального ответа не существует, вы просто выбираете компромисс.

1 голос
/ 07 февраля 2020

нарушит ли это соглашение RESTful для создания новой конечной точки для каждого требуемого показателя?

Нет.

Помните, что эталонное приложение для архитектурного стиля REST - это всемирная паутина. Добавление новой веб-страницы - совершенно нормальная вещь. Так что это с ресурсов .

Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...