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

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

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

POST https://api.iot.yandex.net/v1.0/groups/{group_id}/actions

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

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

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

Массив actions

Тип CapabilityObject

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

HTTP/1.1 200 OK

{
  "status": "ok",
  "request_id": String,
  "devices": [{
      "id": String,
      "capabilities": [{
        "type": String,
        "state": {
          "instance": String,
          "action_result": {
            "status": String
          }
        }
      }]
    },
    {
      "id": String,
      "capabilities": [{
        "type": String,
        "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/groups/light-group-id-1/actions' \
--header 'Authorization: Bearer YOUR_OAUTH_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "actions": [
        {
            "type": "devices.capabilities.on_off",
            "state": {
                "instance": "on",
                "value": true
            }
        }
    ]
}'

HTTP/1.1 200 OK

{
  "status": "ok",
  "request_id": "35e9d24a-40f3-409d-b654-2cf4d87fe593",
  "devices": [{
      "id": "lamp-id-1",
      "capabilities": [{
        "type": "devices.capabilities.on_off",
        "state": {
          "instance": "on",
          "action_result": {
            "status": "DONE"
          }
        }
      }]
    },
    {
      "id": "lamp-id-2",
      "capabilities": [{
        "type": "devices.capabilities.on_off",
        "state": {
          "instance": "on",
          "action_result": {
            "status": "DONE"
          }
        }
      }]
    },
    {
      "id": "lamp-id-3",
      "capabilities": [{
        "type": "devices.capabilities.on_off",
        "state": {
          "instance": "on",
          "action_result": {
            "status": "DONE"
          }
        }
      }]
    }
  ]
}

HTTP/1.1 404 Not Found

{
    "request_id": "667b3e0f-47a8-4136-9211-b4ff59062315",
    "status": "error",
    "message": "Группа устройств не найдена"
}