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

Способ запроса

Запросы от Яндекс.Маркета передаются по протоколу HTTPS в следующем формате:

<тип-метода> https://<URL_запроса>/<ресурс>
где:

  • <тип-метода> ― зависит от ресурса;

  • <URL_запроса> ― URL-адрес, на который магазин принимает запросы от Яндекс.Маркета (указывается в личном кабинете);

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

Примечание. При каждом запросе Яндекс.Маркет передает авторизационный токен через URL-параметр либо HTTP-заголовок.

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

URL-адрес

Магазинам рекомендуется указывать базовый URL, например: https://shop.ru/market/api. Для такого примера запрос POST /cart будет приходить на URL https://shop.ru/market/api/cart.

Сетевым магазинам рекомендуется указывать различные URL для разных магазинов, и таким образом, чтобы по URL можно было определить, к какому магазину идет вызов, например:

  • https://shop-network.ru/market/api/Moscow;

  • https://shop-network.ru/market/api/Ekaterinburg;

  • https://shop-network.ru/market/api/St-Petersburg.

Такое разграничение помогает правильно реализовать логику API внутри сети магазинов.

Таймаут

При обращении к магазину Яндекс.Маркет использует таймауты на соединение и получение ответа. Если магазин не успевает ответить на запрос в течение указанного таймаута, Яндекс.Маркет засчитывает магазину ошибочный ответ. Таймаут на соединение составляет 1 секунду, таймаут на получение ответа зависит от ресурса и указан на соответствующей странице ресурса.

Способ запроса Таймаут URL-адрес