Разработка на REST API

Через REST API сайт разговаривает с внешним миром: заявки уходят в CRM, товары и остатки приходят из учётной системы, оплаты подтверждаются банком, доставка считает стоимость, карты отдают адреса. Мы и подключаемся к чужим API, и открываем собственные методы, когда с данными сайта должна работать другая система.

Любую интеграцию пишем с расчётом на то, что вторая сторона однажды не ответит. Таймауты, повторные попытки, очередь, логи и уведомления об ошибках — не перестраховка, а необходимый минимум: без них потерянный заказ обнаруживается через неделю по жалобе клиента.

При проектировании своих методов отделяем данные от представления и версионируем: изменение формата не должно ломать интеграции, которые уже кто-то использует. Плюс авторизация и ограничение частоты запросов — открытый метод без защиты рано или поздно найдут и начнут выкачивать вашу базу.

Где применяем REST API

Когда это не нужно

Интеграция живёт вместе с чужой системой: при её обновлении обмен нужно проверять заново.

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