Популярные архитектурные стили API

На диаграмме ниже показаны распространенные архитектурные стили API на одном рисунке.

🔹 1. REST
Предложенный в 2000 году, REST является наиболее используемым стилем. Он часто используется между клиентскими и серверными сервисами. Он соответствует 6 архитектурным ограничениям. Формат payload (полезной нагрузки) может быть JSON, XML, HTML или обычный текст.

🔹 2. GraphQL
GraphQL был предложен компанией Meta в 2015 году. Он предоставляет схему и систему типов, подходящую для сложных систем, в которых отношения между объектами подобны графу. Например, на диаграмме ниже GraphQL может получить информацию о пользователе и заказе за один вызов, тогда как в REST для этого требуется несколько вызовов.

GraphQL не является заменой REST. Его можно построить на основе существующих сервисов REST.

🔹 3. Websocket
Веб-сокет — это протокол, обеспечивающий полнодуплексную связь по протоколу TCP. Клиенты устанавливают веб-сокеты для получения обновлений в реальном времени от серверных служб. В отличие от REST, который всегда «извлекает» данные, веб-сокет позволяет «проталкивать» данные.

🔹 4. Webhook
Веб-хуки обычно используются сторонними асинхронными вызовами API. Например, на приведенной ниже диаграмме мы используем Stripe или Paypal для платежных каналов и регистрируем веб-хук для получения результатов оплаты. Когда сторонняя платежная служба завершена, она уведомляет платежную службу, если платеж был успешным или неудачным. Вызовы веб-хуков обычно являются частью конечного автомата системы.

🔹 5. gRPC
Выпущенный в 2016 году gRPC используется для связи между микросервисами. Библиотека gRPC обрабатывает кодирование/декодирование и передачу данных.

🔹 6. SOAP
SOAP означает простой протокол доступа к объектам. Его payload является только XML, подходящий для связи между внутренними системами.

https://t.me/itarchitecture