---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.0
alternate:
  - https://yandex.ru/dev/dialogs/smart-home/doc/en/reference/get-devices-jrpc.md
  - https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference/get-devices-jrpc.md
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference/get-devices-jrpc.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/dialogs/smart-home/doc/ru/llms.txt?revision=r21995741
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/dialogs/smart-home/doc/ru/llms.txt?revision=r21995741

# Информация об устройствах пользователя

<!-- source: ru/_includes/reusables/neuroexpert-button.md -->



<!-- endsource: ru/_includes/reusables/neuroexpert-button.md -->


Запрашивает информацию о поддерживаемых устройствах пользователя.

Платформа умного дома отправит провайдеру текущий запрос при выполнении условий:

- Аккаунты на Яндексе и на стороне провайдера [связаны](https://yandex.ru/dev/dialogs/smart-home/doc/auth/about-account-linking.html?lang=ru).
- Пользователь зашел в приложение [![](../_images/smart-home-app.svg) Дом с Алисой](https://alice.yandex.ru/smart-home)&nbsp;→ ![Плюс](../_images/plus.svg)&nbsp;→ **Устройство умного дома** и напротив названия производителя нажал кнопку **Обновить**.

{% note info %}

После связки аккаунтов на Яндексе и на стороне провайдера также отправляется данный запрос.

{% endnote %}


В ответ на такой запрос провайдеру необходимо вернуть список всех поддерживаемых устройств пользователя с описанием доступных [умений](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/capability-types.md) и [свойств](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/properties-types.md). Максимальное количество устройств пользователя — 301.

Если часть устройств недоступна и провайдер не смог отправить информацию о них, платформа умного дома оставит эти устройства пользователя без изменений. Удалить устройство из списка может только сам пользователь.

## Формат запроса платформы умного дома {#input}

Платформа умного дома отправляет запрос на Endpoint URL провайдера (https://example.com).


```bash translate=no
POST https://functions.yandexcloud.net/<function_id>?integration=raw
```

#### Формат тела запроса {#structure-in}

```json translate=no
{
  "headers": {
    "request_id": String,
    "authorization": String
  },
  "request_type": String,
  "api_version": Float
}
```

<!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/get-devices-input.md -->
<!-- discovery -->
<!--  Query -->

#|
||
**Параметр**
|
**Тип**
|
**Описание**
|
**Обязательный**
||

||
headers
|
[Object](*object)
|
<!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/headers-ph.md -->
Объект с дополнительными полями запроса.
<!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/headers-ph.md -->
|
Да
||

||
request_type
|
[String](*string)
|
Тип запроса. Допустимые значения:
- discovery — информация об устройствах пользователя.
|
Да
||

||
<!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/api_version-row-col-1.md -->
api_version
<!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/api_version-row-col-1.md -->
|
<!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/api_version-row-col-2.md -->
[Float](*float)
<!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/api_version-row-col-2.md -->
|
<!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/api_version-row-col-3.md -->
Версия протокола Умного дома.
<!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/api_version-row-col-3.md -->
|
<!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/api_version-row-col-4.md -->
Да
<!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/api_version-row-col-4.md -->
||
|#

<br>

<!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/headers-tgroup.md -->
**Объект `headers`**

#|
||
**Параметр**
|
**Тип**
|
**Описание**
|
**Обязательный**
||

||
request_id
|
[String](*string)
|
Идентификатор запроса. Необходимо логировать на стороне провайдера для расследования инцидентов и проблем.
|
Да
||

||
authorization
|
[String](*string)
|
Авторизационный токен пользователя.
|
Да
||
|#
<!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/headers-tgroup.md -->
<!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/get-devices-input.md -->



## Формат ответа провайдера {#output-structure}

Провайдер должен ответить на полученный от платформы умного дома запрос согласно формату.

{% list tabs %}

- Успешный ответ


  ```json translate=no
  {
    "request_id": String,
    "payload": {
        "user_id": String,
        "devices": [
          {
            "id": String,
            "name": String,
            "description": String,
            "room": String,
            "type": String,
            "custom_data": Object,
            "capabilities": [
              "<capability1>": Object,
              "<capability2>": Object,
              ...
            ],
            "properties": [
              "<property1>": Object,
              "<property2>": Object,
              ...
            ],
            "device_info": {
              "manufacturer": String,
              "model": String,
              "hw_version": String,
              "sw_version": String
            }
          },
          ...
        ]
    }
  }
  ```

  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/get-devices-response-jrpc.md -->
  <!-- Response -->


  #|
  ||
  **Параметр**
  |
  **Тип**
  |
  **Описание**
  |
  **Обязательный**
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/request_id-col-1.md -->
  request_id
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/request_id-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/request_id-col-2.md -->
  [String](*string)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/request_id-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/request_id-col-3.md -->
  Идентификатор запроса.
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/request_id-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/request_id-col-4.md -->
  Да
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/request_id-col-4.md -->
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/payload-col-1.md -->
  payload
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/payload-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/payload-col-2.md -->
  [Object](*object)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/payload-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/payload-col-3.md -->
  Объект с устройствами.
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/payload-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/payload-col-4.md -->
  Да
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/payload-col-4.md -->
  ||
  |#

  <br>

  **Объект `payload`**

  #|
  ||
  **Параметр**
  |
  **Тип**
  |
  **Описание**
  |
  **Обязательный**
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/user_id-row-col-1.md -->
  user_id
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/user_id-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/user_id-row-col-2.md -->
  [String](*string)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/user_id-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/user_id-row-col-3.md -->
  Идентификатор пользователя.
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/user_id-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/user_id-row-col-4.md -->
  Да
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/user_id-row-col-4.md -->
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/devices-row-col-1.md -->
  devices
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/devices-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/devices-row-col-2.md -->
  [Array](*array) of [objects](*object)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/devices-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/devices-row-col-3.md -->
  Массив с устройствами пользователя.
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/devices-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/devices-row-col-4.md -->
  Да
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/devices-row-col-4.md -->
  ||
  |#

  <br>

  **Объект `devices`**

  #|
  ||
  **Параметр**
  |
  **Тип**
  |
  **Описание**
  |
  **Обязательный**
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/device-id-row-col-1.md -->
  id
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/device-id-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/device-id-row-col-2.md -->
  [String](*string)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/device-id-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/device-id-row-col-3.md -->
  Идентификатор устройства. Должен быть уникален среди всех устройств производителя.
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/device-id-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/device-id-row-col-4.md -->
  Да
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/device-id-row-col-4.md -->
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/name-row-col-1.md -->
  name
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/name-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/name-row-col-2.md -->
  [String](*string)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/name-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/name-row-col-3.md -->
  Название устройства.
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/name-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/name-row-col-4.md -->
  Да
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/name-row-col-4.md -->
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/description-row-col-1.md -->
  description
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/description-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/description-row-col-2.md -->
  [String](*string)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/description-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/description-row-col-3.md -->
  Описание устройства.
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/description-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/description-row-col-4.md -->
  Нет
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/description-row-col-4.md -->
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/room-row-col-1.md -->
  room
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/room-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/room-row-col-2.md -->
  [String](*string)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/room-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/room-row-col-3.md -->
  Название помещения, в котором расположено устройство.
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/room-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/room-row-col-4.md -->
  Нет
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/room-row-col-4.md -->
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/type-row-col-1.md -->
  type
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/type-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/type-row-col-2.md -->
  [String](*string)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/type-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/type-row-col-3.md -->
  Тип устройства. Со списком типов устройств можно ознакомиться в разделе [Типы устройств](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/device-types.md).
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/type-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/type-row-col-4.md -->
  Да
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/type-row-col-4.md -->
  ||

  ||
  custom_data
  |
  [Object](*object)
  |
  Объект, который состоит из набора пар `"ключ":"значение"` любой вложенности и представляет собой дополнительную информацию об устройстве. Содержимое объекта не должно превышать 1024 байт. Платформа умного дома сохранит этот объект и будет отправлять его в запросах
   [Информация о состояниях устройств пользователя](https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference/post-devices-query-jrpc.md), [Изменение состояния у устройств](https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference/post-action-jrpc.md).
  |
  Нет
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capabilities-row-col-1.md -->
  capabilities
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capabilities-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capabilities-row-col-2.md -->
  [Array](*array) of [objects](*object)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capabilities-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capabilities-row-col-3.md -->
  Массив с информацией об [умениях](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/capability-types.md) устройства.
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capabilities-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capabilities-row-col-4.md -->
  Да, если отсутствует `properties`
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capabilities-row-col-4.md -->
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/properties-row-col-1.md -->
  properties
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/properties-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/properties-row-col-2.md -->
  [Array](*array) of [objects](*object)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/properties-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/properties-row-col-3.md -->
  Массив с информацией о [свойствах](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/properties-types.md) устройства.
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/properties-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/properties-row-col-4.md -->
  Да, если отсутствует `capabilities`
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/properties-row-col-4.md -->
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/device_info-row-col-1.md -->
  device_info
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/device_info-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/device_info-row-col-2.md -->
  [Object](*object)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/device_info-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/device_info-row-col-3.md -->
  Дополнительная техническая информация об устройстве. Чтобы посмотреть эту информацию, на главном экране приложения [![](../_images/smart-home-app.svg) Дом с Алисой](https://alice.yandex.ru/smart-home) выберите устройство, в правом верхнем углу нажмите ![Изображение шестеренки](../_images/settings.svg) и выберите **Об устройстве**. Данная информация поможет быстрее идентифицировать устройство при обращении пользователя в поддержку Яндекса или к производителю.
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/device_info-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/device_info-row-col-4.md -->
  Да, для [официальных навыков](https://yandex.ru/dev/dialogs/smart-home/doc/ru/certification.md)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/device_info-row-col-4.md -->
  ||
  |#

  <br>

  **Объект `capabilities`**

  #|
  ||
  **Параметр**
  |
  **Тип**
  |
  **Описание**
  |
  **Обязательный**
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capability1-row-col-1.md -->
  \<capability1>
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capability1-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capability1-row-col-2.md -->
  [Object](*object)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capability1-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capability1-row-col-3.md -->
  Описание умения. Подробнее со списком доступных умений и их параметрами можно ознакомиться в разделе [Об умениях](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/capability-types.md).
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capability1-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capability1-row-col-4.md -->
  Нет
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capability1-row-col-4.md -->
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capability2-row-col-1.md -->
  \<capability1>
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capability2-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capability2-row-col-2.md -->
  [Object](*object)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capability2-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capability2-row-col-3.md -->
  Описание умения. Подробнее со списком доступных умений и их параметрами можно ознакомиться в разделе [Об умениях](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/capability-types.md).
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capability2-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capability2-row-col-4.md -->
  Нет
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/capability2-row-col-4.md -->
  ||
  |#

  <br>

  **Объект `properties`**

  #|
  ||
  **Параметр**
  |
  **Тип**
  |
  **Описание**
  |
  **Обязательный**
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property1-row-col-1.md -->
  \<property1>
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property1-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property1-row-col-2.md -->
  [Object](*object)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property1-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property1-row-col-3.md -->
  Описание свойства. Подробнее со списком доступных свойств и их параметрами можно ознакомиться в разделе [О свойствах](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/properties-types.md).
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property1-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property1-row-col-4.md -->
  Нет
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property1-row-col-4.md -->
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property2-row-col-1.md -->
  \<property2>
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property2-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property2-row-col-2.md -->
  [Object](*object)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property2-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property2-row-col-3.md -->
  Описание свойства. Подробнее со списком доступных свойств и их параметрами можно ознакомиться в разделе [О свойствах](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/properties-types.md).
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property2-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property2-row-col-4.md -->
  Нет
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property2-row-col-4.md -->
  ||
  |#

  <br>

  **Объект `device_info`**

  #|
  ||
  **Параметр**
  |
  **Тип**
  |
  **Описание**
  |
  **Обязательный**
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/manufacturer-row-col-1.md -->
  manufacturer
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/manufacturer-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/manufacturer-row-col-2.md -->
  [String](*string)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/manufacturer-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/manufacturer-row-col-3.md -->
  Название производителя устройства. Может содержать до 256 символов. Параметр является обязательным для описания официального навыка (подробнее в разделе [Обзор](https://yandex.ru/dev/dialogs/smart-home/doc/ru/about.md)).
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/manufacturer-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/manufacturer-row-col-4.md -->
  Да, для [официальных навыков](https://yandex.ru/dev/dialogs/smart-home/doc/ru/certification.md)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/manufacturer-row-col-4.md -->
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property2-row-col-1.md -->
  \<property2>
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property2-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property2-row-col-2.md -->
  [Object](*object)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property2-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property2-row-col-3.md -->
  Описание свойства. Подробнее со списком доступных свойств и их параметрами можно ознакомиться в разделе [О свойствах](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/properties-types.md).
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property2-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property2-row-col-4.md -->
  Нет
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/property2-row-col-4.md -->
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/model-row-col-1.md -->
  model
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/model-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/model-row-col-2.md -->
  [String](*string)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/model-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/model-row-col-3.md -->
  Название модели устройства. Может содержать до 256 символов.Параметр является обязательным для описания официального навыка (подробнее в разделе [Обзор](https://yandex.ru/dev/dialogs/smart-home/doc/ru/about.md)).
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/model-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/model-row-col-4.md -->
  Да, для [официальных навыков](https://yandex.ru/dev/dialogs/smart-home/doc/ru/certification.md)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/model-row-col-4.md -->
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/hw_version-row-col-1.md -->
  hw_version
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/hw_version-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/hw_version-row-col-2.md -->
  [String](*string)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/hw_version-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/hw_version-row-col-3.md -->
  Версия аппаратной составляющей устройства. Может содержать до 256 символов.
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/hw_version-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/hw_version-row-col-4.md -->
  Нет
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/hw_version-row-col-4.md -->
  ||

  ||
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/sw_version-row-col-1.md -->
  sw_version
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/sw_version-row-col-1.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/sw_version-row-col-2.md -->
  [String](*string)
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/sw_version-row-col-2.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/sw_version-row-col-3.md -->
  Версия программного обеспечения устройства. Может содержать до 256 символов.
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/sw_version-row-col-3.md -->
  |
  <!-- source: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/sw_version-row-col-4.md -->
  Нет
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/sw_version-row-col-4.md -->
  ||
  |#
  <!-- endsource: ru/_includes/reference/struct-table-protocol/id-struct-table-protocol/get-devices-response-jrpc.md -->



- Ответ с ошибкой


  <!-- source: ru/_includes/reference/check-jrpc/id-output-structure/cloud.md -->
  Подробнее о том, как отдавать коды состояния, отличные от `200 OK`, читайте в [документации](https://cloud.yandex.ru/docs/functions/concepts/function-invoke#response).
  <!-- endsource: ru/_includes/reference/check-jrpc/id-output-structure/cloud.md -->


  ```json translate=no
  HTTP/1.1 404 Not Found
  ```

  [Глобальные коды](https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/response-codes.md#enq-with-error-codes)

{% endlist %}


## Пример {#example-JSON}

В примере описаны свойства светильника с регулировкой цвета.

> {% list tabs %}
>
> - Запрос
>
>
>   ```bash translate=no
>   curl -i POST https://functions.yandexcloud.net/<function_id>?integration=raw \
>   -H 'Content-Type: application/json' \
>   -d '{
>         "headers": {
>           "request_id": "1111-aaaa-2222-bbbb",
>           "authorization": "Bearer 123qwe456a..."
>         },
>         "request_type": "discovery",
>         "api_version": 1.0
>   }'
>   ```
>
>
> - Успешный ответ
>
>
>   ```json translate=no
>   HTTP/1.1 200 OK
>
>   {
>       "request_id": "1111-aaaa-2222-bbbb",
>       "payload": {
>           "user_id": "Misha-01-super-545",
>           "devices": [{
>                   "id": "abc-123",
>                   "name": "лампa",
>                   "description": "цветная лампа",
>                   "room": "спальня",
>                   "type": "devices.types.light",
>                   "custom_data": {
>                     "foo": 1,
>                     "bar": "two",
>                     "baz": false,
>                     "qux": [1, "two", false],
>                     "quux": {
>                       "quuz": {
>                         "corge": []
>                       }
>                     }
>                   },
>                   "capabilities": [{
>                           "type": "devices.capabilities.range",
>                           "retrievable": true,
>                           "parameters": {
>                               "instance": "brightness",
>                               "unit": "unit.percent",
>                               "range": {
>                                   "min": 0,
>                                   "max": 100,
>                                   "precision": 10
>                               }
>                           }
>                       },
>                       {
>                           "type": "devices.capabilities.on_off"
>                       },
>                       {
>                           "type": "devices.capabilities.color_setting",
>                           "parameters": {
>                               "color_model": "hsv",
>                               "temperature_k": {
>                                   "min": 2700,
>                                   "max": 9000,
>                                   "precision": 1
>                               }
>                           }
>                       }
>                   ],
>                   "device_info": {
>                       "manufacturer": "Provider2",
>                       "model": "hue g11",
>                       "hw_version": "1.2",
>                       "sw_version": "5.4"
>                   }
>               }
>
>           ]
>       }
>   }
>   ```
>
>
> - Ответ с ошибкой
>
>
>   ```json translate=no
>   HTTP/1.1 401 Unauthorized
>   ```
>
> {% endlist %}


<!-- source: ru/_includes/about/id-support/support-button.md -->
[![Служба поддержки](../_images/support-image.svg)](https://yandex.ru/dev/dialogs/smart-home/doc/ru/feedback.md)
<!-- endsource: ru/_includes/about/id-support/support-button.md -->

[*object]:
  Список пар `"ключ": значение`, разделенных запятой. Выделяется фигурными скобками `{}`.

```json translate=no
{
  "name": "John",
  "surname": "Smith"
}
```

[*string]:
  Cтрока, выделяется кавычками, например `"Hello world"`.

[*array]:
  Массив элементов, разделенных запятой. Элементом могут быть стандартные элементы JSON: строка, число, `true`, `false`, объект или массив. Массив выделяется квадратными скобками `[]`:

```json translate=no
"cities": ["Moscow", "Tokyo", "New York"]
```

[*float]:
  Число с плавающей точкой с точностью до 6-9 десятичных знаков.