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

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

Запросы можно задавать в двух форматах — с указанием версии API и без указания версии. Оба формата одинаково поддерживаются.

<тип_метода> https://api.partner.market.yandex.ru/v<версия_API>/<ресурс>.<формат_ответа>?<параметры>

где:

  • <тип_метода> ― DELETE, GET, POST или PUT.
  • <версия_API> ― номер текущей версии API. На данный момент текущая версия — 2.
  • <ресурс> ― URL ресурса, над которым выполняется действие. Названия ресурсов приведены в описании соответствующих методов.
  • <формат_ответа> ― это необязательная часть запроса, которая влияет на способ представления ответа. Формат ответа может быть указан в HTTP-заголовке Accept. Данные передаются в формате JSON. В описании каждого метода приведены примеры запросов и ответов.
  • <параметры> ― обязательные и необязательные параметры запроса, которые не входят в состав URL ресурса.
<тип_метода> https://api.partner.market.yandex.ru/<ресурс>.<формат_ответа>?<параметры>

где:

  • <тип_метода> ― DELETE, GET, POST или PUT.
  • <ресурс> ― URL ресурса, над которым выполняется действие. Названия ресурсов приведены в описании соответствующих методов.
  • <формат_ответа> ― это необязательная часть запроса, которая влияет на способ представления ответа. Формат ответа может быть указан в HTTP-заголовке Accept. Данные передаются в формате JSON. В описании каждого метода приведены примеры запросов и ответов.
  • <параметры> ― обязательные и необязательные параметры запроса, которые не входят в состав URL ресурса.

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