🔌 API: REST, SOAP, gRPC и интеграции

API — это меню в ресторане. Ты не идёшь на кухню, а заказываешь по названиям из списка. Меню и есть контракт: что можно заказать и что получишь

Сравнение

Как это работает

REST: сервис выставляет адреса вроде /orders и /orders/42. Создать заказ — POST, прочитать — GET, изменить — PUT или PATCH, удалить — DELETE. Ответ содержит код: 200 успех, 404 не найдено, 500 ошибка на сервере. Эти коды полезно знать, чтобы понимать логи и разговор команды

SOAP: запрос и ответ в XML-конвертах, строго по описанию WSDL. Если контрагент говорит «у нас SOAP», это значит долгое согласование контракта и мало гибкости

Интеграция как проект

1. Контракт раньше кода. Договоритесь о формате данных и ошибках до разработки, иначе обе стороны сделают по-своему
2. Тестовый контур. Запроси его у контрагента первым делом, его отсутствие — главный риск
3. Заглушки. Пока контур не дали, команда работает на моках по контракту
4. Версионирование. Изменение API ломает всех клиентов, нужны версии и переходный период
5. Ошибки и повторы. Что делать, если ответ не пришёл: повторить, отложить, сообщить

Пример из жизни

Интеграция с банком по SOAP. Банк прислал WSDL на 200 страниц и тестовый контур через пять недель после старта. Менеджер заранее попросил команду написать заглушку по WSDL и договорился с банком об ответственном за вопросы по контракту. Когда контур дали, переключение заняло два дня. Без заглушки команда простаивала бы месяц

Важно запомнить

• API — договор, его согласование занимает больше времени, чем код
• REST везде, SOAP у банков и госсистем, gRPC между сервисами
• Тестовый контур и контракт — первые два вопроса менеджера на любой интеграции

Как ответить на собесе

Связанные темы