Skip to content

Вебхуки

Как ваша система получает заказы

GoSync не отправляет исходящие вебхуки на URL вашей системы. Получение заказов выполняется по опросу (polling):

  1. GET /api/v1/1c/orders — запрос новых заказов (и при необходимости следующих batch).
  2. GET /api/v1/1c/orders/updates?since=... — запрос изменений по уже выгруженным заказам (статусы, состав).
  3. GET /api/v1/1c/orders/{order_id} — полный снимок одного заказа по UUID (без batch, в любой момент).

Рекомендуемый сценарий: периодически вызывать GET /orders (например раз в минуту или по расписанию), обрабатывать заказы, подтверждать batch через POST /orders/confirm; для обновлений статусов и состава — GET /orders/updates с параметром since (время последнего известного обновления). Если нужны все поля конкретного заказа — GET /orders/{order_id}.

Исходящие вебхуки (перспектива)

Возможность уведомлять вашу систему о новом заказе в реальном времени (исходящий webhook от GoSync на ваш URL) может быть добавлена в будущем. Сейчас используйте опрос GET /api/v1/1c/orders.