API и интеграции
API (application programming interface) — набор правил и возможностей внутри программы, через которые другая программа может с ней взаимодействовать, в отличие от человеческого интерфейса. Это «контракт» между программой, которая предлагает API, и сторонними программами или устройствами (MDN). Интеграция — подключение двух систем через такой контракт, чтобы они обменивались данными без ручного переноса.
Простыми словами
Когда вы ищете отделение Новой почты на сайте магазина, сайт не лезет в базу перевозчика. Он отправляет запрос в специальное «окошко» (API) и получает ответ: список городов и отделений. Так же сайт может передать заказ в CRM, а учётная система — вернуть остатки.
Интеграция — это работа, которая использует API: кто-то настраивает, какие данные, когда и в какую сторону передавать.
Как системы обмениваются данными
Есть несколько способов. Все они встречаются в магазине.
- Запрос за запросом (API). Одна система сама обращается к другой: «дай остатки», «создай накладную». Правила запроса описаны в документации API. Для описания API существуют стандарты: спецификация OpenAPI имеет версию 3.2.1 от 10 сентября 2026 года (OpenAPI Initiative).
- Webhook. Система сама сообщает другой, когда что-то произошло: оплачен заказ, изменился статус. По Wikipedia, это «пользовательские HTTP-колбэки»: при событии источник отправляет запрос на заданный вами адрес, и получателю не нужно постоянно опрашивать систему (Wikipedia, Webhook).
- Файлы. Выгрузка таблицы или XML, как в товарных фидах. Просто, но медленно и без мгновенных обновлений.
- Готовый модуль или коннектор. Поставщик уже сделал связку между двумя популярными сервисами; вы лишь включаете её и вводите ключ.
Зачем это магазину
Без интеграций данные между системами переносят руками: заказы с сайта в CRM, остатки в учётную систему, накладные в службу доставки. Это медленно и приводит к ошибкам.
Типичные связи магазина:
- сайт и платёжный сервис: оплата и статус (способы оплаты);
- сайт и ПРРО: фискальный чек по заказу;
- сайт и служба доставки: накладные, статусы, наложенный платёж;
- сайт, CRM и OMS или WMS: заказы, остатки, статусы;
- каталог и PIM, маркетплейсы.
Когда нужно
Когда вы замечаете, что кто-то ежедневно переносит данные между системами или что остатки на сайте расходятся со складом.
Когда ещё рано
Когда систем две-три, а обмен в несколько заказов в день. Тогда готового модуля, а то и ручного переноса хватает. Не стоит строить сложную связку ради порядка, который пока не нужен.
Безопасность и надёжность
- API-ключи — это «пароли» между системами. Не рассылать их в мессенджерах и не публиковать.
- Webhook следует проверять: Wikipedia называет распространённые способы аутентификации входящих запросов (общий секрет, цифровая подпись, HMAC-подпись в заголовке) и проверку времени запроса против повторов (Wikipedia, Webhook).
- Что происходит при сбое: интеграция должна повторять отправку и показывать ошибки, иначе заказ «зависает» незамеченным.
- Кто отвечает: поставщик сервиса или ваш интегратор. Это стоит знать до запуска.
- Персональные данные клиентов, которые ходят между системами, подпадают под закон о защите персональных данных. Это не юридический совет.
Типичные ошибки
- Интеграция в одну сторону, а данные меняются в обеих системах: расхождения.
- Нет единого ключа заказа в разных системах.
- Никто не следит за ошибками обмена.
- Закрытая система без API: позже с ней ничего не соединить. Перед выбором сервиса спрашивайте, есть ли открытый API и экспорт данных (SaaS).
FAQ
Что такое API простыми словами? Способ, которым одна программа просит другую о данных или действии по заранее описанным правилам.
Что такое интеграция в интернет-магазине? Автоматическое соединение систем: сайт передаёт заказ в CRM или учёт, служба доставки возвращает статус.
Чем webhook отличается от API? Через API вы сами запрашиваете данные. Webhook — система сама сообщает вам, когда что-то произошло.
Нужен ли программист для интеграции? Для готового модуля обычно нет, для нестандартной связки да. Зависит от систем, которые вы соединяете.
Связанные термины
Источники
- MDN, API (Glossary) — developer.mozilla.org/en-US/docs/Glossary/API
- Wikipedia, Webhook — en.wikipedia.org/wiki/Webhook
- OpenAPI Initiative, OpenAPI Specification v3.2.1 (10.09.2026) — spec.openapis.org/oas/latest.html
- Верховна Рада України, Закон № 2297-VI — zakon.rada.gov.ua/laws/show/2297-17
Конкретные возможности API Новой почты смотрите в её документации (developers.novaposhta.ua).
Свежих данных о том, как украинские магазины интегрируют системы, нет.
Читайте также
OMS и WMS
OMS (order management system) — система управления заказами: принимает заказы из всех каналов, ведёт их статусы и решает, откуда и чем их выполнять. WMS (warehouse management system) — система управления складом: фиксирует поступление и отгрузку товара…
CRM
CRM (customer relationship management) — подход и, как правило, программа для управления взаимодействием с клиентами: она хранит данные о них, анализирует их и помогает согласовывать продажи, маркетинг и поддержку (Wikipedia, CRM).
CDP
CDP (customer data platform) — программное обеспечение, которое собирает данные о клиентах из всех систем компании, сводит их в один профиль человека, хранит этот профиль постоянно и отдаёт его другим системам: аналитике, маркетингу, поддержке. CDP Institute…
Учётная система
Учётная система — программа, в которой компания ведёт бухгалтерский и товарный учёт: документы о продажах и закупках, остатки на складе, деньги на счетах, расчёты с контрагентами. Из неё берут данные для отчётности и налогов.