Руководство разработчика
Ресурсы API

Вызов ресурсов

Запросы к API Яндекс.Маркета передаются по протоколу HTTPS.

Формат запроса:

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

где:

  • <тип_метода> ― в API Яндекс.Маркета для запросов используется только метод GET.

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

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

  • <формат_ответа> ― это необязательная часть запроса, которая влияет на способ представления ответа.

    Возможные форматы ответа: XML и JSON. По умолчанию данные передаются в формате XML.

    В описании каждого ресурса приведены примеры запросов и ответов для обоих форматов.

    Внимание! API Яндекс.Маркета возвращает ответы в кодировке UTF-8.
  • <параметры> ― обязательные и необязательные параметры запроса, которые не входят в состав URL ресурса.

    Для регионозависимых ресурсов необходимо передавать параметр geo_id — идентификатор региона.

    Для списочных ресурсов можно указывать параметры: page — номер страницы результатов, которую необходимо показать в ответе; count — количество выводимых результатов на странице ответа.

    Остальные параметры зависят от конкретного ресурса и приведены в описании ресурсов.

Для всех запросов в HTTP-заголовке Authorization обязательно указывается авторизационный ключ.

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

GET Вызов ресурсов Формат запроса Формат ответа Параметры запроса XML JSON Версии API Регионозависимые ресурсы Списочные ресурсы