Гайд по оᴍ́г торговая площадка: как подключить и настроить API интеграцию

Этот гайд поможет подключить oмг-платформу через API, сократить время обработки заказов на 60% и избежать сбоев при синхронизации остатков. Поддерживает более 10 000 продавцов, обрабатывает до 500 000 заказов в день. В отличие от Яндекс.Маркета, Wildberries или Ozon, oмг предоставляет прямой доступ к API-данным в реальном времени, что критично для автоматизации логистики и интеграции с 1С, ERP-системами и складскими решениями

Важно: Никаких ручных действий при импорте данных, только API. Для продавцов, обрабатывающих более 100 заказов в день, подключение через API снижает ошибки на 40% и ускоряет обработку на 60%

1. Первым делом, зарегистрируйтесь в официальном сайте oмг. Даже если у вас уже есть аккаунт на маркетплейсе, отдельная учетка для API-доступа обязательна. Процесс занимает 5 минут. Забудьте про «через личку», это не работает.
2. Создайте новый ключ доступа в разделе «Интеграции» → «API-ключи». Укажите название: например, «Магазин_2026». Система выдаст пару: client_id и secret_key. Сохраните оба, потеря ключа означает пересоздание
3. Настройте CORS-политику Критически важный момент: если не добавить домен вашего сервера в белый список, запросы будут отклоняться с ошибкой 403 Forbidden. Добавьте https://your-store.ru и http://localhost:3000 (если тестируете).
4. Используйте POST /v1/orders/sync для импорта заказов. Пример тела запроса:

   { "order_id": "OMG20260701001", "items": [ {"product_id": 12345, "quantity": 2, "price": 999} ], "status": "confirmed"
   }

   Важно: статус должен быть именно confirmed, иначе система не обработает.
5. Настройте вебхуки: POST /webhook/order_status. Когда статус заказа изменится (например, с «pending» на «shipped»), платформа пришлет вам уведомление. Это работает даже если у вас 1000 заказов в день, вы не пропустите ни одного.

Совет: для тестов используйте blacksprut mega ЌРÁЌÉH: гайд по выбору и использованию искусственной наживки как источник данных. Там есть примеры запросов с реальными параметрами, можно копировать в Postman и запускать.

Проверьте статус интеграции: если всё работает, 200 OK и "status": "success". Если приходит 401 Unauthorized, проверьте, что ключи введены правильно. Ошибка 429 Too Many Requests означает, что вы превысили лимит в 100 запросов в минуту. Снизьте частоту.

Типичные ошибки:

• Забыли включить SSL-сертификат на сервере, без него запросы падают.
• Неверный формат даты: используйте ISO 8601 (2026-07-01T10:00:00Z), иначе система отклонит.
• Пытаетесь использовать GET вместо POST, это не работает. API не поддерживает GET-запросы для изменений.

Для продвинутых: включите rate_limit в настройках. Если у вас 1000+ товаров, так вы не упертесь в лимиты и не получите 500 ошибок

Чек-лист:

• ✅ Создан ключ API
• ✅ Добавлен домен в CORS
• ✅ Открыт доступ к /webhook
• ✅ Тестовый заказ прошел успешно
• ✅ Проверена дата в ISO формате

После настройки, запускайте в продакшене. Первые 24 часа могут быть «шумными»: появятся ошибки 500, но если статусы возвращаются, это нормально. Система сама перезапускает подключения.

Вопрос–ответ:

• Какие ошибки чаще всего возникают при интеграции? Неправильная обработка кодов ошибок 400/500; рекомендуется использовать логирование и тестовый режим перед запуском в продакшн.
• Сколько продавцов уже подключены к API oмг? Более 10 000 активных интеграций, из них 78% используют API для автоматизации заказов.
• Какой рост за последние 12 месяцев? Доля автоматизированных заказов выросла с 42% до 67%, за счет внедрения REST API и вебхуков.
• Что делать, если вебхук не приходит? Проверьте, что URL доступен извне, открыт порт 443, и включен HTTPS. Также убедитесь, что тело запроса соответствует формату JSON.

официальное ссылка оᴍ́г оᴍ́г