Вызов методов

Запросы к партнерскому API Яндекс.Маркета передаются по протоколу HTTPS, таймаут — 10 секунд, Keep-Alive не поддерживается.

Запрос задается в следующем формате:

<тип_метода> https://api.partner.market.yandex.ru/v<версия_API>/<ресурс>.<формат_ответа>?<параметры>
где:
  • <тип_метода> ― DELETE, GET, POST или PUT.

  • <версия_API> ― номер текущей версии API. На данный момент текущая версия — 2.

  • <ресурс> ― URL ресурса, над которым выполняется действие. Названия ресурсов приведены в описании соответствующих методов.

  • <формат_ответа> ― это необязательная часть запроса, которая влияет на способ представления ответа. Формат ответа может быть указан в HTTP-заголовке Accept. Возможные форматы ответа: JSON и XML. По умолчанию данные передаются в формате XML. В описании каждого метода приведены примеры запросов и ответов.

  • <параметры> ― обязательные и необязательные параметры запроса, которые не входят в состав URL ресурса.

Примечание. Для каждого метода в HTTP-заголовке Authorization или в параметрах URL запроса необходимо передавать авторизационные данные: авторизационный токен (oauth_token) и идентификатор приложения (oauth_client_id).

В случае возникновения ошибки обработка запроса прекращается и возвращается сообщение об ошибке. Список ошибок и их описания приведены в разделе Сообщения об ошибках.