Заголовки запросов

Обновлено 4 октября 2024

Структура используется во всех запросах к API и вебхуку.

Заголовок	Обязательный?	Описание
Content-Type	✔︎	Формат передаваемых или отправляемых данных. Используется json
Authorization	✔︎	Авторизационный токен. Вендор или приложение-агент на контроллере отправляет запросы со своим ключом, умный дом Sber — с access-токеном пользователя. Подробнее об авторизации: Cloud-to-Cloud: см. раздел Авторизация при запросах. MQTT-to-Cloud для интегратора: см. раздел Добавить контроллер и получить данные для его авторизации.
X-Request-Id		Идентификатор запроса. Используется для логирования

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