Checks
The Yandex.Market marketplace regularly checks the store's API in the automatic mode. A robot performs a specific set of requests to the store. The store must respond to them and send the necessary information in the response body.
If within 30 minutes the store received at least 10 requests (both from the robot and with real orders) and responded to more than 10% of them incorrectly, it is automatically disconnected from the Yandex.Market marketplace. An incorrect response is:
The absence of response within a specified timeout.
The
200 OK
response containing invalid data in the response body.The
400 Bad Request
,500 Internal Server Error
responses, as well as responses with codes other than200 OK
.
The store can debug its application in the personal account before the checks start.
Check types
There are the following API checks:
Checks are performed according to the following scheme:
Before connecting to the Yandex.Market marketplace | During the operation | Within a day after disconnection | Before reconnecting | |
---|---|---|---|---|
Store availability via API | — | ✔ | ✔ | ✔ |
Troubleshooting of the request processing errors | — | ✔ | ✔ | — |
Correct authorization of the Yandex.Market marketplace | — | ✔ | — | ✔ |
Before connecting to the Yandex.Market marketplace | During the operation | Within a day after disconnection | Before reconnecting | |
---|---|---|---|---|
Store availability via API | — | ✔ | ✔ | ✔ |
Troubleshooting of the request processing errors | — | ✔ | ✔ | — |
Correct authorization of the Yandex.Market marketplace | — | ✔ | — | ✔ |
Regular availability check via API
The pinger robot constantly checks the store's availability via the API, making requests to the store using the POST /cart
method. The store must send responses to each request, passing all necessary information in the response.
The check period: during participation in the program, within a day after disconnecting, before re-connecting to the Yandex.Market marketplace.
The check frequency: once in 10 minutes. In case of an incorrect response, the pinger robot starts checking with a frequency 1 time per minute.
Request errors processing check
If a store processes the Yandex.Market POST /order/accept
and POST /order/status
requests incorrectly, the robot performs an additional check of the store using the POST /order/accept
request method. If a store returns a correct order acceptance response, the robot cancels the order within 10 minutes using the POST /order/status
request method with the CANCELLED status.
Verification period:
While working with the Yandex.Market marketplace — only if errors in processing the specified requests are found.
Within a day after disconnection — only if errors in processing the specified requests are found during the participation in the program.
Check frequency: once per minute after the error is detected. Within a day after disconnection, the check is done once in 10 minutes.
Regular authorization check of the Yandex.Market marketplace
The store must be able to identify requests from the Yandex.Market and distinguish them from unauthorized third-party requests by checking the authorization token.
As part of the check, the store is passed an invalid authorization token. The store should return the 403 Forbidden
error. If the store returns a code other than 403
, the request logs will show an error. The store should fix the error, otherwise it is disconnected from the program.
The check period: during participation in the program, before re-connecting to the Yandex.Market marketplace.
Check frequency: once per day.