API Яндекс Маркета для продавцов
API Маркета помогает продавцам управлять ассортиментом и ценами, обрабатывать заказы, обновлять остатки и решать множество других задач.
API состоит из двух независимых компонентов: pull-компонента (магазин отправляет запросы Маркету) и push-компонента (Маркет отправляет запросы магазину). Интеграция каждого из компонентов настраивается отдельно.
Компоненты API Маркета
Pull (магазин → Маркет ⇢ магазин) |
Push (Маркет → магазин ⇢ Маркет) |
|
Как устроен |
Магазин делает запросы к Маркету, когда ему это нужно. Он может это делать по графику или когда происходят определенные события — например, завершается подготовка отгрузки. |
Маркет сам отправляет запросы магазину. На все такие запросы необходимо сразу отвечать — поэтому сервер магазина должен быть постоянно на связи. |
Авторизация |
Магазин добавляет в свои запросы специальный авторизационный токен. Маркет проверяет токен и отвечает, только если все в порядке. Инструкция |
В запросах, которые Маркет отправляет магазину, есть авторизационный токен. Магазин обязательно должен проверять его, прежде чем отвечать на запрос. Инструкция |
Обязательность |
Такая интеграция понадобится для решения любых задач с помощью API. |
Без такой интеграции можно обойтись. |
Как используется |
Необходим для решения любых задач. Например:
|
Push-компонент предлагает альтернативный режим обработки заказов. В этом режиме Маркет сам сигнализирует магазину, если появился новый заказ или что-то изменилось в одном из старых, — поэтому нет необходимости настраивать отдельные уведомления или регулярную проверку. |
𝓠 Так надо поддерживать оба компонента или достаточно одного?
𝓐 Скорее всего, вам хватит pull-компонента (магазин → Маркет ⇢ магазин). Push-компонент требует отдельной разработки и поддержки постоянно работающего сервера, а предназначен в первую очередь для самых крупных магазинов.
Как настроить интеграцию
- Прочитайте страницу Api-Key. Там рассказано, как авторизоваться для доступа к ресурсам.
- Прочитайте инструкцию по подключению OpenAPI-спецификации.
- Посмотрите раздел Пошаговые инструкции — если там есть инструкция для вашей задачи, начните с нее.
- Откройте обзор методов API для нужной модели и выберите те, что нужны для решения задачи.
- Прочитайте детальное описание каждого метода и реализуйте интеграцию.
Новые интеграции
Не рекомендуем настраивать новые интеграции с push-компонентом.
-
В кабинете в левом нижнем углу нажмите на название своего бизнеса и перейдите на страницу Модули и API. На вкладке Получение запросов от Маркета активируйте опцию Включить запросы от Маркета.
Если вкладки Получение запросов от Маркета нет, напишите службе поддержки — в кабинете выберите Общение → Поддержка → Создать обращение → Работа через API.
-
Прочтите раздел Авторизация для запросов Маркета к магазину.
-
Откройте обзор методов API, посмотрите описание каждого и реализуйте интеграцию.