Интеграция по API на заказ: коннектор к любой системе с журналом и повторами
Связываем две или несколько систем, у которых есть API, документация или хотя бы выгрузка файлов, — так, чтобы обмен переживал сбои и было видно, что с ним происходит.
Для простых сценариев хватает конструкторов интеграций вроде Albato или ApiX-Drive: событие в одной системе — действие в другой. Свой коннектор нужен, когда логика сложнее одного шага, у системы нет готового модуля в конструкторе, данные надо сверять и склеивать, объёмы большие или нельзя передавать данные через сторонний сервис.
Начинаем с документации и тестового доступа. Пишем короткий прототип, который проходит авторизацию и выполняет ключевой запрос: так ещё до сметы видно, что API действительно отдаёт нужные данные, какие у него лимиты и как он ведёт себя при ошибках. Протокол не важен: REST и JSON, SOAP и XML, вебхуки, файлы на FTP или SFTP, очереди сообщений.
Главное в интеграции — не первый успешный запрос, а поведение при сбое. Каждая операция получает свой идентификатор, чтобы повтор не создал второй заказ или второй платёж. Неудачные запросы уходят в очередь с нарастающей паузой, всё пишется в журнал, а о том, что обмен остановился, вы узнаёте из Telegram, а не от клиента.
Типовой проект · пакет «Орбита»
94 600 ₽
2–3 недели
- Разбор API и прототип
- Карта данных
- Надёжная доставка
- Журнал и мониторинг
Конструктор интеграций или свой коннектор
Конструктор
- Подходит для простых сценариев «событие — действие»
- Быстрый запуск без программиста
- Работает с системами из каталога конструктора
- Данные проходят через сторонний сервис
Свой коннектор
- Многошаговая логика, сверка и склейка данных
- Любой протокол: REST, SOAP, файлы, очереди
- Работает на вашем сервере или сервере в РФ
- Журнал, повторы и мониторинг под ваш процесс
Возможности
Из чего состоит интеграция
Разбор API и прототип
Авторизация, ключевые методы, лимиты и формат ошибок проверяются на реальном тестовом доступе.
Карта данных
Какие сущности и поля куда передаются, какая система главная, как сопоставляются записи.
Надёжная доставка
Очередь, повторы с паузой, защита от дублей при повторной отправке.
Журнал и мониторинг
Каждая операция с исходными данными и ответом системы, уведомления об остановке обмена.
Передача кода и документации
Исходный код, описание настроек и инструкция, куда смотреть при ошибке.
Калькулятор
Интеграция по API на заказ — расчёт стоимости
Отраслевые модули уже отмечены. Уберите лишнее или добавьте нужное — сумма в счёте будет та же, что в смете.
Выберите пакет
Добавьте нужное
Ваша смета
- Пакет «Орбита»59 900 ₽
- Разбор документации и прототип9 900 ₽
- Очередь, повторы и защита от дублей19 900 ₽
- Уведомления в Telegram4 900 ₽
Стоимость работ
94 600 ₽
Срок: 2–3 недели
Счёт сейчас: 47 300 ₽ — предоплата 50%, остаток после приёмки
Без регистрации. Счёт и анкета придут на почту сразу. Гарантия 3 месяца после запуска.
Что нужно для оценки
По этому списку мы называем цену и срок без долгих созвонов.
- Названия систем и ссылки на их документацию API
- Тестовый доступ или песочница хотя бы у одной стороны
- Какие данные и в какую сторону должны передаваться
- Как часто: сразу по событию, раз в час, раз в сутки
- Примерный объём: сколько записей в день
- Кто сейчас делает эту работу вручную и как
Что отличает надёжную интеграцию от скрипта
Повтор создаёт дубль
Таймаут при создании заказа, скрипт отправляет запрос снова — и заказов два. Нужен идентификатор операции и проверка перед созданием.
Ошибка проглатывается
Скрипт пишет ошибку в консоль, которую никто не читает. Каждый сбой должен попадать в журнал и уведомление.
Нет учёта лимитов
При большом объёме API начинает отвечать отказами, и часть данных теряется. Запросы идут через очередь с учётом ограничений.
Ключи в коде
Токены хранятся в репозитории и попадают к посторонним. Храним их в серверных настройках с минимальными правами.
Пример: дистрибьютор, которому нужно связать свою систему заказов с API поставщика
Пакет «Орбита» (59 900 ₽) + разбор документации и прототип (9 900 ₽) + очередь, повторы и защита от дублей (19 900 ₽) + журнал обменов (14 900 ₽). Итог — около 104 600 ₽ и 2–3 недели, плюс сопровождение 5 900 ₽ в месяц по желанию. Заказы уходят поставщику автоматически, повторная отправка после сбоя не создаёт дубль, а в журнале видно, что и когда ответила другая сторона.
Собрать свой вариантВопросы и ответы
Вопросы об интеграции по API
Почему не взять конструктор интеграций?
Для простых сценариев это разумный выбор, и мы так и советуем. Свой коннектор оправдан, когда логика многошаговая, нужна сверка и склейка данных, объёмы большие, системы нет в конструкторе или данные нельзя передавать через сторонний сервис.
У системы плохая документация. Возьмётесь?
Да, но начинаем с платного прототипа: проверяем авторизацию и ключевые методы на тестовом доступе. Если API не отдаёт нужных данных, вы узнаёте это до основной сметы.
Что такое защита от дублей и зачем она?
Если ответ на запрос потерялся, коннектор не знает, создан ли заказ, и отправляет его снова. Уникальный идентификатор операции позволяет второй системе или нашему узлу распознать повтор и не создать вторую запись.
Где будет работать коннектор?
На вашем сервере или на нашем сервере в РФ. Код, ключи доступа и журнал принадлежат вам, мы передаём всё вместе с документацией.
Что будет, когда другая сторона изменит API?
Журнал и мониторинг покажут ошибки сразу. В рамках сопровождения адаптируем коннектор к новой версии; без сопровождения правку оцениваем отдельно.
Источники и проверка сведений
Смотрите также
Похожие решения
Спросите что угодно о заказе: сколько будет стоить ваш проект, что входит в пакет, как платить, какие документы получите.