Первоначальные сведения

Партнерский API предоставляет сторонним автоматизированным системам интерфейс взаимодействия с функциями партнерского интерфейса Яндекс.Маркета.

Для получения информации из партнерского интерфейса или использования его функций магазин передает запросы к партнерскому API Яндекс.Маркета с указанием входных данных. В ответ партнерский API возвращает необходимые данные или результат выполнения операций.

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

Примечание. Если магазин размещается на Яндекс.Маркете через рекламное агентство, по умолчанию доступ к работе с партнерским API открыт для сотрудников агентства. Чтобы самостоятельно работать с API, магазин может обратиться в свое агентство, которое, в свою очередь, запросит в службе поддержки Яндекс.Маркета доступ для сотрудников магазина.

Партнерский API Яндекс.Маркета построен по принципам REST.

Ресурсы

Ресурс — это целостная часть системы, с которой можно взаимодействовать при помощи партнерского API. Все действия выполняются с помощью HTTP-запросов на URL-адреса ресурсов:

  • удалить ресурс (метод DELETE);

  • читать содержимое и текущее состояние ресурса (метод GET);

  • выполнить специальные действия ― например, добавить новые элементы в список (метод POST);

  • изменить содержимое и состояние и записать его в ресурс (метод PUT).

У каждого ресурса есть свой уникальный URL. Например, чтобы получить информацию о магазине, необходимо сделать GET-запрос на URL магазина, чтобы установить ставки на предложения, необходимо сделать PUT-запрос со значениями ставок на URL ресурса, отвечающего за ставки.

Описание ресурсов и операций, которые с ними можно выполнить, а также примеры запросов и ответов смотрите в разделе Ресурсы API.