Query headers

Last updated on February 3, 2025

The structure is used for all queries to APIs and webhooks.

Name	Mandatory?	Description
Content-Type	✔︎	Format of data transmitted or sent. Json is used
Authorization	✔︎*	Authorization token. The vendor or an agent app installed on the controller sends queries with its own key, while Sber Smart Home sends them with the user's access token. More about authorization: Cloud-to-Cloud: see Authorization upon queries. MQTT-to-Cloud for integrator: see Having your controller authorized in Sber cloud * The authorization token is required for all requests except requests to check vendor's endpoint accessibility: the vendor must return a response even to unauthorized requests
X-Request-Id		Reqiest ID. Used for logging

POST /v1/devices HTTP/1.1
Host: example.com
Content-Type: application/json
Authorization: Bearer qwerty-1234-...
X-Request-Id: abcd-0000-ifgh-...