API, который переживёт смену команды и рост продукта

API, который переживёт смену команды и рост продукта
Разработка API — это проектирование контракта, по которому живут все системы бизнеса: сайт, приложение, CRM, 1С, платежи, маркетплейсы. Хороший API замечают редко. Плохой — сразу: заказы не доходят, интеграции падают, партнёры уходят.
В Scroll Media начинаем не с фреймворка, а с вопроса: кто и как будет использовать этот API через год — когда появятся новые клиенты и версии. Ответ на него определяет, станет API активом или техническим долгом.
Что делаем: REST и GraphQL, контракт через OpenAPI, авторизация, обработка отказов, версионирование, sandbox для партнёров.
Для кого: SaaS, e-commerce, B2B-порталы, мобильные приложения, партнёрские платформы.
Сколько стоит: от 3 000 BYN, ставка — 70 BYN/час.
Четыре решения, которые отделяют работающий API от проблемного
1. Контракт фиксируем до кода.
OpenAPI с эндпоинтами, форматами, ошибками и версиями. Фронтенд и партнёры работают параллельно с backend, а не ждут «когда будет готово». Без контракта появляются «устные договорённости» — и через месяц никто не помнит, где право, а где лево.
2. Отказы проектируем как часть работы.
Сеть падает, внешний сервис отвечает через 30 секунд, пользователь дважды нажал «оплатить». Что произойдёт с заказом? Если ответ «не знаем» — это лотерея. Закладываем idempotency keys, retry с backoff, таймауты, dead letter queue, понятные коды ошибок.
3. Безопасность — в контракте, а не «добавим потом».
JWT, OAuth 2.0, API-ключи, scopes, валидация схемами, rate limiting, ротация секретов. Публичный API — открытая дверь в систему, поэтому OWASP Top 10 — базовый уровень, а не чекбокс. Плюс мониторинг аномалий: если ключ «стучится» в 100 раз чаще обычного — вы узнаете сразу.
4. Версионирование с первого дня.
/v1, /v2, deprecation-политика. Новые клиенты работают со свежей версией, старые не ломаются, миграция — управляемый процесс, а не пожар.
Как проходит работа
Неделя 1
Диагностика, контракт (OpenAPI), схема данных, согласование.
Недели 2–3
Реализация: эндпоинты, авторизация, обработка отказов, тесты.
Неделя 4
Sandbox для партнёров, нагрузочные тесты, документация.
Неделя 5
Запуск, мониторинг, алерты, передача кода и документации.
Сроки зависят от объёма: простой API — 2–4 недели, API с интеграциями — 4–8 недель.
Что вы получаете на выходе
Исходный код в вашем репозитории — права переданы вам.
Документация OpenAPI — фронтенд и партнёры подключаются без переписки с backend.
Sandbox-окружение — партнёры тестируют до продакшена.
Мониторинг и алерты — видно, что происходит с API в реальном времени.
Версии и deprecation-политика — изменения не ломают существующих клиентов.
Поддержка и доработки — по договору, не «куда вы денетесь».
Типовые задачи, которые решаем
Интернет-магазин с 15 000 SKU и 1С:УТ
Товары, цены, остатки, заказы — синхронизация в обе стороны. Ручной перенос убран, менеджеры не сверяют таблицы, остатки на сайте всегда актуальны.
B2B-портал с партнёрским API
Дилеры получают доступ к каталогу и заказам через sandbox, подключаются сами, без участия разработчика. Нагрузка на поддержку упала в разы.
Мобильное приложение + сайт на одном backend
Один API — два клиента. Данные синхронизированы, поведение предсказуемо, новая функция появляется сразу в обоих каналах.
Возражение: «У нас уже есть API, но он неудобный».
Часто дело не в коде, а в контракте: непоследовательные ответы, нет версий, документация «для галочки». Начинаем с аудита — показываем, что доработать, а что требует новой версии. Переписывать всё нужно редко.
Сколько стоит разработка API
Ставка — 70 BYN/час. Сознательно работаем по нижней границе рынка: часть рутины закрывает инструментарий, экономию передаём клиенту, а не забираем в маржу.
Простой API (CRUD, авторизация, документация) — от 3 000 BYN.
API с интеграциями и обработкой отказов — от 5 600 BYN.
Партнёрский API или микросервисы — от 8 000 BYN, считается индивидуально.
Аудит существующего API — от 800 BYN.
Точную смету называем после диагностики — без скрытых платежей.
Кому подходит
Стартапам и MVP
Корпорациям и B2B
Агентствам и продуктовым командам.