Способ запроса
<тип-метода> https://<URL_запроса>/<ресурс>
где:<тип-метода>
― зависит от ресурса;<URL_запроса>
― URL-адрес, на который магазин принимает запросы от Маркета;<ресурс>
― имя ресурса, над которым выполняется действие.
В случае возникновения ошибки магазин должен прекратить обработку запроса и вернуть сообщение об ошибке. Список ошибок и их описания приведены в разделе Сообщения об ошибках.
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 секунду, таймаут на получение ответа зависит от ресурса и указан на соответствующей странице ресурса.