Какие способы взаимодействия с API существуют? В чем разница между ними?

Основные способы взаимодействия с API делятся по архитектурным стилям и протоколам:

---

1. REST API (Representational State Transfer)

• Архитектурный стиль, работающий поверх HTTP(S).

• Использует стандартные методы: GET, POST, PUT, PATCH, DELETE.

• Формат данных: JSON (иногда XML, YAML).

• Легковесный, кэшируемый, удобен для веба и мобильных приложений.

• Подходит для микросервисов.

Пример:

GET /users/1

Ответ (JSON):

{ "id": 1, "name": "Alex" }

---

2. SOAP (Simple Object Access Protocol)

• Строгий протокол на основе XML.

• Может работать поверх HTTP, SMTP, TCP и других транспортов.

• Имеет WSDL (Web Services Description Language) для описания контрактов.

• Поддерживает WS-Security, транзакции.

• Используется в банковских и корпоративных системах, где важна стандартизация и безопасность.

---

3. GraphQL

• Запросный язык и среда выполнения от Facebook.

• Клиент сам определяет, какие данные нужны.

• Один endpoint (/graphql) вместо множества как в REST.

• Снижает количество запросов, гибок для фронтенда.

• Но требует сложной настройки сервера и контроля производительности.

Пример:

query {
  user(id: 1) {
    name
    email
  }
}

---

4. gRPC (Google Remote Procedure Call)

• Фреймворк от Google поверх HTTP/2.

• Использует Protocol Buffers (protobuf) для сериализации данных.

• Быстрый, двусторонний стриминг, поддерживает множество языков.

• Подходит для highload и микросервисов.

---

5. WebSocket API

• Постоянное двустороннее соединение между клиентом и сервером.

• Подходит для real-time: чаты, биржи, игры.

• Более эффективен, чем HTTP-поллинг.

---

6. RPC (Remote Procedure Call)

• Концепция вызова удаленной функции «как локальной».

• gRPC — современный вариант RPC.

• Подходит для внутренних сервисов, но не всегда удобен для внешних API.

---

Краткая разница

Подход	Формат данных	Особенности
REST	JSON/XML	Легкий, популярный, кэширование, много endpoint’ов
SOAP	XML	Строгий протокол, безопасность, legacy
GraphQL	JSON	Клиент сам выбирает данные, один endpoint
gRPC	Protobuf	Высокая скорость, двусторонний стриминг
WebSocket	JSON/Binary	Real-time, постоянное соединение
RPC	Разный	Вызов функций удаленно, простота в архитектуре