Способ запроса
Запросы от Маркета передаются по протоколу HTTPS в следующем формате:
<method_type> https://<host>/<path_to_market_api>/<resource>
где:
-
<method_type>― зависит от ресурса; -
<host>― доменное имя магазина; -
<path_to_market_api>― путь до API Маркета на вашем сервере; -
<resource>― имя ресурса, над которым выполняется действие.
Примечание
При каждом запросе Маркет передает авторизационный токен через URL-параметр либо HTTP-заголовок.
В случае возникновения ошибки магазин должен прекратить обработку запроса и вернуть сообщение об ошибке. Список ошибок и их описания приведены в разделе Сообщения об ошибках.
URL-адрес
Магазинам рекомендуется указывать базовый URL, например: https://shop.ru/market/api. Для такого примера запрос POST order/accept будет приходить на URL https://shop.ru/market/api/order/accept.
Сетевым магазинам рекомендуется указывать различные 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 секунду, таймаут на получение ответа зависит от ресурса и указан на соответствующей странице ресурса.