API Яндекс Маркета для продавцов

API Маркета помогает продавцам управлять ассортиментом и ценами, обрабатывать заказы, обновлять остатки и решать множество других задач.

API состоит из двух независимых компонентов: pull-компонента (магазин отправляет запросы Маркету) и push-компонента (Маркет отправляет запросы магазину). Интеграция каждого из компонентов настраивается отдельно.

Компоненты API Маркета

Pull (магазин → Маркет ⇢ магазин)

Push (Маркет → магазин ⇢ Маркет)

Как устроен

Магазин делает запросы к Маркету, когда ему это нужно. Он может это делать по графику или когда происходят определенные события — например, завершается подготовка отгрузки.

Маркет сам отправляет запросы магазину. На все такие запросы необходимо сразу отвечать — поэтому сервер магазина должен быть постоянно на связи.

Авторизация

Магазин добавляет в свои запросы специальный авторизационный токен. Маркет проверяет токен и отвечает, только если все в порядке. Инструкция

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

Обязательность

Такая интеграция понадобится для решения любых задач с помощью API.

Без такой интеграции можно обойтись.

Как используется

Необходим для решения любых задач. Например:

  • загрузка каталога товаров;
  • управление контентом на карточках;
  • обработка заказов;
  • связь с покупателем в чате;
  • получение отчетов.

Push-компонент предлагает альтернативный режим обработки заказов. В этом режиме Маркет сам сигнализирует магазину, если появился новый заказ или что-то изменилось в одном из старых, — поэтому нет необходимости настраивать отдельные уведомления или регулярную проверку.

𝓠 Так надо поддерживать оба компонента или достаточно одного?

𝓐 Скорее всего, вам хватит pull-компонента (магазин → Маркет ⇢ магазин). Push-компонент требует отдельной разработки и поддержки постоянно работающего сервера, а предназначен в первую очередь для самых крупных магазинов.

Как настроить интеграцию

  1. Прочтите раздел Авторизация для запросов магазина к Маркету. Там рассказано, как авторизоваться для доступа к ресурсам, и описаны общие правила работы с методами.
  2. Прочтите инструкцию по подключению OpenAPI-спецификации.
  3. Посмотрите раздел Пошаговые инструкции — если там есть инструкция для вашей задачи, начните с нее.
  4. Откройте обзор методов API для нужной модели и выберите те, что нужны для решения задачи.
  5. Прочтите детальное описание каждого метода и реализуйте интеграцию.
  1. Прочтите раздел Авторизация для запросов Маркета к магазину.
  2. Откройте обзор методов API, посмотрите описание каждого и реализуйте интеграцию.