Документация по работе с Merchants API


   

Общая информация

Merchants API от Ozon.Ru предоставляет возможность партнерам, работающим с торговой площадкой (далее мерчанты), реализовать автоматизированный процесс синхронизации своей товарной базы с информационной системой Ozon.Ru и управление заказами. Merchants API представляет из себя вебсервис, построенный на основе REST-архитектуры.

Доступные ресурсы торговой площадки

РесурсОписание
https://api.ozon.ru/merchants/products Управление товарами.
https://api.ozon.ru/merchants/files Управление пакетными загрузками товаров.
https://api.ozon.ru/merchants/jobs Информация о статусе обработки асинхронных вызовов загрузки товаров/файлов с товарами.
https://api.ozon.ru/merchants/xsd Получение структур XML файлов (XSD) для пакетной загрузки товаров.
https://api.ozon.ru/merchants/templates Шаблоны файлов Excel и XML для пакетной загрузки товаров.
https://api.ozon.ru/merchants/orders Управление заказами.

 

Авторизация

Доступ к сервисам имеют только пользователи, заключившие договор с ООО "Интернет Решения". После заключения договора пользователь получает идентификатор (ApplicationId) и секретный ключ (SecretKey). ApplicationId используется для идентификации пользователя в системе, секретный ключ - для аутентификации через проверку подписи. Перед использованием Merchants API вашему приложению необходимо авторизоваться. В результате авторизации вы получите специальный ключ - токен. Токен понадобится при всех последующих обращениях к функциям API. Как получить токен и как его использовать при обращении к API подробно описано в статье Авторизация и аутентификация.

Версионность

Для подготовки к переходу на новые версии Merchants API введен механизм версионности. Одновременно могут быть доступны несколько версий Merchants API, поэтому в заголовке запроса обязательно нужно указывать номер требуемой версии: X-ApiVersion: 0.1 Актуальная версия: 0.1

Справочные данные

Большая часть необходимых справочных данных предоставляется пользователям Merchant API в составе XSD-файлов со структурой файлов загрузки товаров. Перечень разрешенных для использования конкретному мерчанту типов товаров отдельно оговаривается с менеджерами Торговой площадки Ozon.ru на этапе согласования условий договора.

Push-нотификация

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

  • В ответе асинхронных методов возвращается индентификатор задания на обработку, по которому можно запросить текущий статус обработки и информацию по возникшим ошибкам.
  • В качестве альтернативы можно использовать механизм push-нотификации, позволяющий подписаться на уведомления о завершении обработки задания. См. статью Механизм push-нотификации.

Поддерживаемая кодировка

Предпочтительной является кодировка utf-8.