Вызов методов
Запросы к партнерскому API передаются по протоколу HTTPS, таймаут — 10 секунд, Keep-Alive не поддерживается.
Запросы можно задавать в двух форматах — с указанием версии API и без указания версии. Оба формата одинаково поддерживаются.
С указанием версии
Без указания версии
<http_method> https://api.partner.market.yandex.ru/v<version>/<resource>.<format>?<parameters>
где:
<http_method>― DELETE, GET, POST или PUT.<version>― номер текущей версии API. На данный момент текущая версия — 2.<resource>― URL ресурса, над которым выполняется действие. Названия ресурсов приведены в описании соответствующих методов.<format>― это необязательная часть запроса, которая влияет на способ представления ответа. Формат ответа может быть указан в HTTP-заголовкеAccept. Данные передаются в формате JSON. В описании каждого метода приведены примеры запросов и ответов.<parameters>― обязательные и необязательные параметры запроса, которые не входят в состав URL ресурса.
<http_method> https://api.partner.market.yandex.ru/<resource>.<format>?<parameters>
где:
<http_method>― DELETE, GET, POST или PUT.<resource>― URL ресурса, над которым выполняется действие. Названия ресурсов приведены в описании соответствующих методов.<format>― это необязательная часть запроса, которая влияет на способ представления ответа. Формат ответа может быть указан в HTTP-заголовкеAccept. Данные передаются в формате JSON. В описании каждого метода приведены примеры запросов и ответов.<parameters>― обязательные и необязательные параметры запроса, которые не входят в состав URL ресурса.
В случае возникновения ошибки обработка запроса прекращается и возвращается сообщение об ошибке. Список ошибок и их описания приведены в разделе Сообщения об ошибках.