API и интеграции

API-интеграция маркетплейса

Маркетплейс никогда не работает в одиночку. Остатки лежат в ERP, бухгалтерская запись — в сервисе электронных счетов, движение отправления — у перевозчика. Задача слоя API — собрать эти системы в единое работающее целое; иначе нужна команда, которая каждый день переносит данные вручную.

Попробовать бесплатноЗапросить цену
Эндпоинты товаров, заказов, остатков, продавцов и контента
REST APIЭндпоинты товаров, заказов, остатков, продавцов и контента
Событийные уведомления; постоянный опрос не нужен
ВебхукиСобытийные уведомления; постоянный опрос не нужен
Автоматизация по правилам без написания кода
Рабочие процессыАвтоматизация по правилам без написания кода
Импорт по расписанию через XML, CSV и Excel
Массовый переносИмпорт по расписанию через XML, CSV и Excel

Когда задачу решает API, а когда вебхук?

Маркетплейс никогда не работает в одиночку. Остатки продавца лежат в его ERP, бухгалтерская запись — в сервисе электронных счетов, движение отправления — в системе перевозчика, маркетинговые данные — в рекламной платформе. Задача API-интеграции маркетплейса — собрать эти разрозненные системы в единое работающее целое; иначе вам придётся держать команду, которая каждый день переносит данные вручную.

У интеграции два направления, и каждое требует своего инструмента. Забирать данные извне (сведения о товарах и остатках продавца, прайс-лист поставщика) обычно можно импортом по расписанию или вызовами API. А отправлять информацию наружу (создан новый заказ, отправление в пути, открыт возврат) следует вебхуками. Интеграции, построенные на постоянном опросе, и запаздывают, и создают лишнюю нагрузку.

Третья тема — устойчивость. В реальных интеграциях внешняя система не отвечает, одно и то же событие приходит дважды, а запрос уходит в таймаут. Поэтому ключи идемпотентности, автоматические повторы, ограничение частоты запросов и очередь ошибок — не украшения по желанию, а базовые требования. В PazaryeriSoft они входят в состав слоя API.

Модули

Модули, готовые в слое API

REST API и документация

Эндпоинты по ресурсам, единый формат ошибок и пагинация. Команда интеграции работает с примерами запросов и ответов.

Управление вебхуками

Какое событие уходит на какой адрес, задаётся в панели; история доставок и неуспешные попытки доступны для просмотра.

Управление ключами API и областями доступа

Отдельный ключ для каждой интеграции; для каждого ключа задаются права на чтение и запись и ограничение по IP.

Идемпотентность и повторы

Повторное поступление одного и того же запроса не создаёт дубль; неуспешные вызовы повторяются с нарастающими интервалами.

Ограничение частоты и квоты

Для каждой интеграции задаётся лимит запросов; при приближении к нему в заголовках ответа возвращается предупреждение.

Импорт из XML, CSV и Excel

Импорт по расписанию регулярно синхронизирует каталоги продавцов и поставщиков; сопоставление полей делается один раз.

Автоматизация рабочих процессов

Задание правил без кода: при определённом условии отправить уведомление, добавить метку, ограничить продавца или сделать запрос во внешний сервис.

Массовая выгрузка

Выгрузка данных о заказах, товарах и выплатах для отчётности и хранилища данных.

Журналы запросов и очередь ошибок

Входящие и исходящие вызовы записываются; ошибочные операции собираются в очередь и могут быть перезапущены вручную.

Проверка подписанных запросов

Тела вебхуков подписываются; принимающая сторона может убедиться, что запрос действительно пришёл от вас.

Интерфейсы без привязки к поставщику

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

Экосистема приложений

Дополнительные модули и сторонние приложения подключаются к платформе через тот же слой API.

Охват

Поверхность API и уведомления о событиях

Слева — эндпоинты, которые вы можете вызывать извне, справа — события, о которых система сообщает вам. Большинство интеграций используют и то, и другое.

Поверхность API

  • Эндпоинты товаров, вариантов, категорий и характеристик
  • Обновление остатков и цен; поддержка массового обновления
  • Список заказов, обновление статусов и операции возврата
  • Управление продавцами, магазинами и организациями
  • Записи клиентов, адресов и избранного
  • Управление контентом, кампаниями и промокодами
  • Аутентификация на токенах и авторизация по областям доступа

Уведомления о событиях (вебхуки)

  • Заказ создан, оплачен, отменён, открыт возврат
  • Этикетка сформирована, отправление в пути, доставлено
  • Товар опубликован, отклонён, остаток закончился
  • Заявка продавца одобрена или аккаунт приостановлен
  • Сформирована выплата, одобрена заявка на вывод
  • Проверка источника по подписанному телу запроса
  • Автоматические повторы с нарастающими интервалами при неуспешной доставке
Сценарии

Шесть самых частых интеграций

Все они работают на одном слое API; отличаются только направление данных и триггер.

Синхронизация с ERP и остатками

Изменения остатков и цен в системе продавца попадают на площадку импортом по расписанию или вызовом API; при создании заказа он уходит в ERP вебхуком.

Электронные счета и бухгалтерия

Счета на комиссию и записи о выплатах передаются в сервисы вроде Paraşüt и BirFatura. Записи для сверки формируются на стороне бухгалтерии автоматически.

Логистические системы

Формирование этикеток и обновление статусов идут через интеграции перевозчиков; движение отправления автоматически записывается в заказ.

Маркетинг и аналитика

Данные о заказах и товарах передаются в рекламные платформы и аналитические инструменты; товарные фиды регулярно обновляются.

Размещение на внешних маркетплейсах

Каталог вашей площадки можно передавать во внешние каналы; синхронизация заказов и остатков настраивается в обе стороны.

Собственный фронтенд и headless-использование

Вы можете написать свой интерфейс и использовать платформу только как слой данных; мобильное приложение потребляет тот же API.

FAQ

Часто задаваемые вопросы

Вопросы, которые чаще всего задают команды интеграции.

Они предназначены для разных направлений. Чтобы забирать данные извне (сведения о товарах и остатках продавца, прайс-лист поставщика), используют вызовы API или импорт по расписанию. Чтобы отправлять информацию наружу (создан новый заказ, отправление в пути, открыт возврат), правильный инструмент — вебхук. Решать это постоянным опросом означает и задержки, и лишнюю нагрузку; событийные уведомления снимают обе проблемы.
Нет. В операциях записи используется ключ идемпотентности; второй запрос с тем же ключом не создаёт новую запись, а возвращает результат первой операции. На стороне вебхуков одно и то же событие тоже может прийти повторно, поэтому принимающей системе рекомендуется проверять идентификатор события. Так неизбежные в реальных интеграциях повторные доставки становятся безвредными.
Неуспешные доставки вебхуков автоматически повторяются с нарастающими интервалами. Когда попытки исчерпаны, запись попадает в очередь ошибок и может быть перезапущена вручную из панели. Поскольку входящие и исходящие вызовы записываются, потом можно разобрать, какой запрос когда и с каким ответом завершился; большинство проблем интеграции решается по этим журналам за считанные минуты.
Для каждой интеграции создаётся отдельный ключ. Для каждого ключа задаются права на чтение и запись: например, интеграции отчётности выдают только чтение. При необходимости можно добавить ограничение по IP, а ключ можно отозвать в любой момент. Так компрометация одной интеграции затрагивает не всю систему, а только её область доступа.
Да, для каждой интеграции задаётся лимит запросов. При приближении к нему в заголовках ответа возвращается остаток квоты, чтобы клиент мог сам замедлиться. Для массовых операций вместо поштучных вызовов мы рекомендуем использовать эндпоинты массового обновления или импорт по расписанию: это и быстрее, и не расходует квоту.
Да, для этого есть редактор рабочих процессов. Вы задаёте правила из условий и действий: при определённом состоянии отправить уведомление, пометить заказ, ограничить продавца или сделать запрос во внешний сервис. Значительная часть простых интеграций решается так, без участия разработчика; API нужен только в более сложных сценариях.
Да. Продавцы могут подключить свои ERP или системы учёта через API либо настроить импорт по расписанию в форматах XML, CSV и Excel. Сопоставление полей делается один раз при первичной настройке, дальнейшие импорты используют тот же шаблон. Подбор полей на базе искусственного интеллекта сокращает время подключения каталогов в разных форматах.

Похожие страницы

Мобильное приложение маркетплейса

Приложения для iOS и Android, работающие на том же слое API.

Headless-коммерция

Модель, в которой платформа используется только как слой данных, а фронтенд вы пишете сами.

Платёжная система маркетплейса

Интеграции платёжных организаций, подключаемые через интерфейс без привязки к поставщику.

Все возможности маркетплейса

Полное описание модулей API, рабочих процессов и переноса данных.

Спланируем ваши интеграции вместе

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

Попробовать бесплатноЗапросить цену

REST API + вебхуки · Автоматизация рабочих процессов · Поддержка 24/7