Перейти к основному содержимому

Ozon Seller API

Обзор​

Ozon Seller API — REST API для продавцов на маркетплейсе Ozon. Использует JSON в теле запросов (даже для GET-подобных операций используются POST запросы).

Особенность: Ozon не предоставляет публичный OpenAPI YAML. Документация собрана из официальных источников.

Аутентификация​

Два заголовка в каждом запросе:

Client-Id: <your_client_id>
Api-Key: <your_api_key>

Ключи создаются в Личном кабинете → Настройки → API ключи.

Base URL​

https://api-seller.ozon.ru

Rate Limits​

  • 60 запросов/минуту (стандарт)
  • Некоторые методы имеют индивидуальные лимиты
  • При превышении: HTTP 429 Too Many Requests

Основные разделы API​

Товары​

  • POST /v3/product/import — импорт товаров
  • POST /v2/product/list — список товаров
  • POST /v4/product/info/prices — получение цен
  • POST /v1/product/update/offer-id — обновление артикулов

Заказы​

  • POST /v3/posting/fbs/list — список FBS отправлений
  • POST /v3/posting/fbo/list — список FBO отправлений
  • POST /v2/posting/fbs/ship — отгрузка FBS
  • POST /v1/posting/fbs/cancel — отмена FBS

Цены и остатки​

  • POST /v1/product/import/prices — обновление цен
  • POST /v2/products/stocks — обновление остатков

Финансы​

  • POST /v3/finance/transaction/list — список транзакций
  • POST /v1/finance/realization — отчёт по реализации

Аналитика​

  • POST /v1/analytics/data — аналитические данные
  • POST /v2/analytics/stock_on_warehouses — остатки на складах

Webhooks​

  • POST /v1/webhook/create — создание webhook
  • Поддерживаемые события: order, cancellation, return

Error Codes​

  • 400 — Bad Request (неверные параметры)
  • 401 — Unauthorized (неверные Client-Id / Api-Key)
  • 403 — Forbidden (нет доступа)
  • 404 — Not Found
  • 429 — Too Many Requests (rate limit)
  • 500 — Internal Server Error