Это может сломать вашу интеграцию

Маркет начинает присваивать заказам идентификаторы из более чем девяти знаков (Type: integer<int64>).

Убедитесь, что вы готовы использовать такие длинные идентификаторы — принимать, обрабатывать и отгружать заказы, работать с невыкупами и возвратами.

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

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

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

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

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

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

Как устроен

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

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

Авторизация

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

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

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

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

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

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

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

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

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

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

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

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

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

Не рекомендуем настраивать новые интеграции с push-компонентом

  1. В кабинете в левом нижнем углу нажмите на название своего бизнеса и перейдите на страницу Модули и API. На вкладке Получение запросов от Маркета активируйте опцию Включить запросы от Маркета.

    Нет вкладки «Получение запросов от Маркета»

    Напишите службе поддержки — в кабинете выберите Общение → Поддержка → Создать обращение → Работа через API.

  2. Прочтите раздел Авторизация для запросов Маркета к магазину.

  3. Откройте обзор методов API, посмотрите описание каждого и реализуйте интеграцию.