Самый частый вопрос, который прилетает в брифы: «сколько стоит API-интеграция». Просто так, без контекста. Это всё равно что спросить «сколько стоит стройка». Сарай? Коттедж? Башня? Не зная объекта, ответа нет.

Давайте разберёмся, что скрывается за словом «API-интеграция», какие бывают типы, где обычно сливаются проекты и почему единого ценника на такое не существует.

API на пальцах, без воды

API расшифровывается как application programming interface. Пугаться не надо. Это договор между двумя программами: «если ты пришлёшь мне такой-то запрос, я отвечу в таком-то формате».

Представьте ресторан. У вас есть меню - это описание API. Вы не подходите к повару и не говорите «сделайте что-нибудь», вы говорите «карбонара, размер M, без лука». Повар понимает формат, готовит, приносит ответ - тарелку. Если будете просить «дважды через каждые двадцать минут» - это уже rate limiting, повар через пару часов психанёт.

У систем то же самое. У CRM есть методы «создать клиента», «найти сделку», «обновить статус». У почтового сервиса - «отправить письмо». У платёжки - «создать счёт». Каждый метод принимает строго определённые параметры и возвращает ответ в строго определённом формате.

Интеграция - это когда вы пишете код, который использует API одной или нескольких систем, чтобы они начали работать вместе. CRM в 1С, 1С в почту, почта в телеграм.

Четыре формата API, которые встречаются в деле

В теории их больше, но в реальной B2B-работе постоянно встречаются четыре. Остальные - экзотика.

REST. Самый распространённый. Запросы по HTTP (как в браузере), данные в JSON. Процентов 80-90 современных API - это REST. Битрикс24, amoCRM, большинство платёжных сервисов, Telegram Bot API, Claude и GPT - все REST.

SOAP. Старый тяжёлый протокол, XML-сообщения, много ритуала. Казалось бы, реликт, но в корпоративном мире живёт и процветает. 1С, SAP, банковские бэкенды - сплошь SOAP. Работать с ним неприятно, но если вы интегрируете что-то энтерпрайзное, избежать не выйдет.

GraphQL. Модный REST на стероидах. Клиент сам описывает, что хочет получить в ответе, один запрос вместо десяти. Популярен у фронтенд-команд современных стартапов. В интеграции с внешними системами встречается редко: корпораты на GraphQL почти не ездят.

Webhooks. Обратный случай: не вы дёргаете API, а система сама вызывает ваш URL, когда что-то произошло. Клиент оплатил - прилетел webhook, ваш код его обработал и создал задачу в CRM. Быстро, дёшево, но требует публичного адреса и аккуратной обработки дубликатов.

Ещё иногда мелькают WebSockets (постоянное соединение, поток данных в обе стороны) и gRPC (бинарный протокол для микросервисов), но в классических бизнес-интеграциях они почти не нужны.

В реальном проекте почти всегда комбинация: REST с CRM, webhook с платёжки, SOAP с 1С. Разработчику приходится уметь все диалекты одновременно.

Три сценария, три бюджета

Теперь по делу. Покажу на примерах, как одно и то же слово «API-интеграция» означает абсолютно разные вещи и цены.

Сценарий 1. Витрина заявок из Битрикса в Google Sheets

Выглядит как «пять минут работы». На практике - 1-2 дня даже у крепкого разработчика.

Что нужно сделать:

  • Зарегистрировать webhook в Битриксе, получить secret
  • Настроить Google Sheets API: сервисный аккаунт, скоупы, права на таблицу
  • Написать код, который принимает webhook, преобразует формат и пишет строку в таблицу
  • Добавить обработку ошибок: что если Битрикс прислал 429? Что если Sheets недоступен 5 минут? Куда складывать пропущенные заявки?
  • Настроить логи, чтобы было понятно, что и когда пошло не так

Бюджет на такое: 15-30 тысяч, срок 2-5 дней. Если подрядчик говорит «45 минут, 5 тысяч» - он забыл про обработку ошибок, и потом вы будете ловить потерянные заявки.

Сценарий 2. Двусторонняя синхронизация 1С и CRM

Тут уже взрослая инженерия:

  • Выгрузка клиентов, товаров, цен из 1С (HTTP-сервисы 1С, ВК-ресурсы или файловый обмен)
  • Загрузка заказов и оплат из CRM обратно в 1С
  • Маппинг полей (в 1С поле «контрагент», в CRM - «клиент», надо сопоставлять)
  • Разрешение конфликтов (одного и того же клиента обновили и там, и там в один час - чья версия побеждает)
  • Регламент обмена (раз в час? мгновенно по событию? по расписанию в ночь?)
  • Инкрементальный обмен (не выгружаем всех 50 тысяч клиентов каждые 5 минут)
  • Мониторинг расхождений и алёрты, когда данные разъехались

Бюджет: 200-500 тысяч, срок 4-8 недель. Меньше 150 тысяч - это либо джун-одиночка, либо у подрядчика уже лежит готовый шаблон, который он вам продаст с минимальной допилкой (иногда это ок, иногда - мина замедленного действия).

Сценарий 3. Claude читает договоры и кладёт выжимку в CRM

API-интеграция с LLM - отдельный зверь:

  • Подключение к Claude API (через корпоративный прокси для РФ или через реселлера)
  • Парсинг PDF и DOCX с договорами, извлечение текста
  • Промпт, который вытаскивает из договора ключевые условия: стороны, суммы, сроки, штрафы
  • Запись выжимки в структурированное поле CRM
  • Обработка ошибок модели: галлюцинации, пустые ответы, превышение лимита токенов
  • Бюджетирование: договор на 20 страниц - это 30-40 тысяч токенов, при потоке в 500 договоров в месяц счёт на Claude выходит ощутимый

Бюджет: от 100 тысяч за PoC на пяти договорах, от 300 тысяч за промышленное внедрение с контролем качества. Плюс ежемесячные расходы на саму модель.

Где проекты по API сливаются

Три места, на которых подрядчики прокалываются чаще всего.

Авторизация

Каждая система авторизует по-своему. Битрикс - OAuth плюс webhook с секретом. amoCRM - access token с refresh-механизмом, токен живёт 24 часа. 1С - базовая HTTP-авторизация или OData-токены. Google - сервисные аккаунты в JSON с приватным ключом. Stripe - секретный ключ в заголовке.

Неаккуратная авторизация даёт два исхода, оба неприятные:

  • Токены истекают, интеграция ломается раз в месяц. Сидите и обновляете руками.
  • Токены утекают в логи или в код в гитхабе. Через полгода кто-то их находит и делает в вашей CRM непонятно что.

Обработка ошибок

Сторонний API всегда ненадёжен. Он упадёт. Он будет отдавать 429. Он будет отдавать неожиданные 200 с пустым телом. Он изменит формат без предупреждения в пятницу вечером.

Хорошая интеграция это предусматривает: retry с экспоненциальной задержкой, очередь на обработку, dead letter queue для писем «точно не получилось», алёрты в телеграм. Плохая - падает тихо, вы замечаете через неделю, когда клиент позвонил и спросил, почему его заявку никто не обработал.

Идемпотентность

Повторная отправка одного и того же запроса не должна создавать дубль. Если webhook от платёжки прилетел дважды (а он прилетает, провайдеры ретраят) - заказ должен создаться один раз. На проекте без идемпотентности за месяц обнаруживаются 1200 дублей заявок в CRM, и отделу продаж становится больно.

Если видите в договоре просто «сделаем интеграцию X и Y за N денег» - без упоминания обработки ошибок, очередей, мониторинга и идемпотентности - это красный флаг. Продают только happy path, за всё остальное будут брать отдельно и потом.

Что делать, если не хотите возиться руками

Есть три варианта, в порядке возрастания сложности и цены.

Готовые интеграции. Битрикс Маркет, коробочные коннекторы amoCRM, темплейты в n8n и Make. Если нужно простое «переложи оттуда сюда» и обе системы популярные - часто уже есть коробка за копейки. Про n8n у нас подробный гайд для тех, кто не разработчик, если хотите собирать интеграции самостоятельно без кода.

iPaaS-платформы. Make, Zapier, n8n в облаке. Мышкой собираете pipeline, платите ежемесячно за выполнения. Подходит для нетехнических команд и простой логики. Ограничения начинаются в сложных сценариях: отладка паршивая, бизнес-логика рассыпается по нодам, через полгода поддерживать невозможно.

Кастомная разработка. Когда ни коробка, ни iPaaS не закрывают задачу. Пишется под конкретный кейс, на вашем стеке, с контролем каждого шага. Дороже в разработке, но дешевле в поддержке на горизонте года-двух.

Правило, которым пользуюсь при оценке: если задача разовая и простая - берите iPaaS. Если это интеграция, которая должна жить 5 лет и быть частью бизнеса - пишите кастом.

Почему «сколько стоит API-интеграция» - это всегда неверный вопрос

Потому что ответ зависит от десятка параметров, которые в вопросе не прозвучали:

  • Какие системы интегрируются
  • В каком объёме данные гоняются (10 записей в день или миллион)
  • Насколько критично время доставки (секунда или раз в ночь)
  • Как обрабатывать конфликты и расхождения
  • Кто владелец систем (у своих 1С-ников карт-бланш, у стороннего владельца доступа нет)
  • Какие есть ограничения по безопасности (ПДн, банковская тайна, медицинская)

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

Если нужна оценка конкретной интеграции - опишите сценарий в брифе, разберу за сутки и скажу честно, брать n8n за 3 тысячи в месяц или писать кастом за 300 тысяч разово.

Что запомнить

API - это договор между двумя программами в формате «запрос - ответ». Интеграция - это код, который этот договор использует.

Форматов четыре: REST (в 80% случаев), SOAP (корпораты), GraphQL (модно), Webhooks (обратная сторона). Почти всегда они встречаются в комбинации.

Бюджет зависит от сложности: простая витрина - десятки тысяч, взрослая синхронизация 1С и CRM - сотни, интеграция с LLM - от сотен и выше плюс ежемесячные расходы на модель.

Подрядчик, который называет цену до разбора задачи - либо обманывает, либо готовится обмануть. Обоих вариантов лучше избегать.