Архитектура API - что включать

Question

Я создаю RESTful api для проекта на данный момент, API будет использоваться для веб-приложения, мобильного приложения и, возможно, в конечном итоге для настольного приложения.

Есть несколько случаев, когда электронные письма необходимо отправлять, чтобы уведомить пользователя о событии, которое произошло в приложении. То, что я не уверен, заключается в том, где закончить работу с API-интерфейсом, должен ли API отвечать за отправку писем или приложение отправляет электронные письма на основе того, какой ответ приходит из API?

В основном, что я спрашиваю, где начинать и заканчивать работу API-интерфейсом, является ли работа API-интерфейсом только с даты от точки A до точки B? Или это может быть более глубокие возможности?

Answer 1

Это распространенная ошибка, которую многие разработчики все еще делают. API - это просто интерфейс, через который вы можете открыть доступ к вашей базовой системе другими системами. Как вы раскрываете свою систему, зависит от того, какие функции вы хотите видеть во внешнем мире. Более того, ваша бизнес-логика должна быть полностью на вашем бэкэнд, а не распространяться по вашим мобильным/веб-приложениям.

Сказав это, мой ответ - да! Не думайте об этом, так как «мой API отправляет электронные письма». Подумайте об этом как о том, что «моя ОСНОВНАЯ СИСТЕМА отправляет электронные письма». Независимо от того, хотите ли вы раскрывать эту функцию электронной почты через свой API или нет, это совсем другая вещь.