Единый API для бронирований, расчётов и платежей

• Проект: единая CRM-платформа для аренды автомобилей.
• Формат работы: разработка интеграционного слоя.
• Роль 1IS: контракты API, маршрутизация, безопасность запросов и документация.

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

HTTP API на PHP маршрутизирует запросы к специализированным сервисам CRM. Общий слой отвечает за проверку клиента, подписи и ограничений, а реестр маршрутов служит источником OpenAPI-документации.

Что реализовали

• Получение справочников, расчёт стоимости и проверка доступности автомобилей.
• Работа с контактами, компаниями, реквизитами и заявками.
• Создание предварительной брони и операции с платежами.
• HMAC-аутентификация, проверка времени и одноразового значения запроса.
• Ограничение частоты, идемпотентность операций и журналирование.
• Генерация спецификации OpenAPI и документации.

Партнёрская система отправляет подписанный запрос на проверку доступности. API проверяет клиента и передаёт параметры сервису бронирования. При создании предварительной брони выполняется свежая проверка занятости, после чего возвращается структурированный результат.

Маршруты имеют явные контракты и правила доступа. Защита от воспроизведения запросов и идемпотентность решают разные задачи. Бизнес-логика используется через общие сервисы, а не копируется в интеграционный слой.

Подготовлена единая точка программного доступа к функциям CRM и документация для подключения потребителей. Расчёты и проверки доступности доступны внешним системам через согласованные контракты.

• PHP.
• HTTP и JSON.
• Битрикс24 CRM.
• HMAC-SHA256 - подпись запросов.
• OpenAPI - спецификация интерфейсов.