Управление умениями устройств

Отправляет действия на устройства пользователя.

Формат запросаФормат запроса

POST https://api.iot.yandex.net/v1.0/devices/actions

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

Формат тела запросаФормат тела запроса

{
	"devices": [{
		"id": String,
		"actions": [{
			"type": "devices.capabilities.{capability}",
			"state": {}
		}]
	}]
}

Массив devices

Тип DeviceActionsObject

Массив actions

Тип CapabilityObject

Формат ответаФормат ответа

HTTP/1.1 200 OK

{
   "status": "ok",
   "request_id": String,
   "devices": [{
      "id": String,
      "capabilities": [{
         "type": "devices.capabilities.{capability}",
         "state": {
            "instance": String,
            "action_result": {
               "status": String;
            }
         }
      }]
   }]
}

HTTP/1.1 404 Not Found

{
    "request_id": String,
    "status": "error",
    "message": String
}

ПримерПример

Запрос

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

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

curl --request POST 'https://api.iot.yandex.net/v1.0/devices/actions' \
--header 'Authorization: Bearer YOUR_OAUTH_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "devices": [
        {
            "id": "lamp-id-1",
            "actions": [
                {
                    "type": "devices.capabilities.on_off",
                    "state": {
                        "instance": "on",
                        "value": true
                    }
                }
            ]
        }
    ]
}'

HTTP/1.1 200 OK

{
   "status": "ok",
   "request_id": "4901aee0-85bf-4b04-9b12-de0f18d23d1e",
   "devices": [{
      "id": "lamp-id-1",
      "capabilities": [{
         "type": "devices.capabilities.on_off",
         "state": {
            "instance": "on",
            "action_result": {
               "status": "DONE"
            }
         }
      }]
   }]
}

HTTP/1.1 404 Not Found

{
    "request_id": "4901aee0-85bf-4b04-9b12-de0f18d23d1e",
    "status": "error",
    "message": "Устройства не найдены"
}