ym88659208ym87991671
Getting Pings from Vendor’s Endpoint (get ping) | Documentation SmartMarket
Skip to main content

Getting Pings from Vendor’s Endpoint (get ping)

From time to time, Sber Smart Home pings a vendor’s endpoint to make sure it is available. If a vendor’s endpoint becomes unavailable, users cannot manage the vendor devices in Sber Salut, SberBox, SberPortal and other devices supported with Sber assistants.

Query format

Sber Smart Home sends a query to the vendor's endpoint. For the headers, see Query headers.

GET /v1/ping

Response format

The vendor sends a response to the Sber Smart Home endpoint. For the headers, see Query headers.

Success response:

HTTP/1.1 200 OK

When an error occurs, an object of the Common error (common error) type should be returned:

{
"code": integer,
"message": string,
"details": list<string>
}

Sample query and response

Sber Smart Home sends a query (ping) to make sure the vendor's endpoint is available.

Query:

curl -i -X GET /v1/ping HTTP/1.1 \
-H Host: example.com \
-H Content-Type: application/json \
-H Authorization: Bearer qwerty-1234-... \
-H X-Request-Id: abcd-0000-ifgh-...

Success response:

HTTP/1.1 200 OK

Error response:

{
"code": 503,
"message": "Server unavailable",
"details": []
}