Заголовки запросов
Обновлено 3 февраля 2025
Структура используется во всех запросах к API и вебхуку.
| Заголовок | Обязательный? | Описание |
| Content-Type | ✔︎ | Формат передаваемых или отправляемых данных. Используется json |
| Authorization | ✔︎* | Авторизационный токен. Вендор или приложение-агент на контроллере отправляет запросы со своим ключом, умный дом Sber — с access-токеном пользователя. Подробнее об авторизации:
* Авторизационный токен обязателен для всех запросов, кроме запросов проверки доступности эндпоинта вендора (get ping): вендор должен возвращать ответ даже на неавторизованные запросы |
| 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-...