Request method

Requests from Yandex.Market are transmitted over HTTPS in the following format:

<method_type> https://<host>/<path_to_market_api>/<resource>

where:

• <method_type> ― depends on the resource.

• <host> ― the store's domain name.

• <path_to_market_api> ― the path to the Yandex.Market API on your server.

• <resource> ― the name of the resource that the action is being performed on.

With each request, the Market transmits authorization token via a URL parameter or an HTTP header.

If an error occurs, the store must stop processing the request and return an error message. The list of errors and their descriptions are given in the section Error messages.

The URL

It is recommended that stores specify a base URL, for example: https://shop.ru/market/api. For such an example, request POST order/accept it will be sent to the URL https://shop.ru/market/api/order/accept.

It is recommended that online stores specify different URLs for different stores, so that the URL can determine which store the call is going to, for example:

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

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

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

This distinction helps to correctly implement the API logic within the store network.

Timeout

When contacting the store, the Market uses timeouts to connect and receive a response. If the store does not have time to respond to the request within the specified timeout, the Market will credit the store with an erroneous response. The connection timeout is 1 second, and the response timeout depends on the resource and is indicated on the corresponding resource page.

Find out more

Request and response data format