Управление запуском сценария

Запускает сценарий пользователя по переданному идентификатору сценария.

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

POST https://api.iot.yandex.net/v1.0/scenarios/{scenario_id}/actions

scenario_id

Идентификатор сценария пользователя.

Заголовок	Описание	Обязательный
Authorization	Авторизационный токен oauth-приложения.	Да

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

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

HTTP/1.1 200 OK

{
    "request_id": String,
    "status": "ok"
}

Параметр

Тип

Описание

Обязательный

request_id

String

Идентификатор запроса. Необходимо логировать для расследования инцидентов.

Да

status

String

Статус обработки запроса. Допустимые значения:

Да

HTTP/1.1 404 Not Found

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

Параметр	Тип	Описание	Обязательный
request_id	String	Идентификатор запроса. Необходимо логировать для расследования инцидентов.	Да
status	String	Статус обработки запроса. Допустимые значения: `error`.	Да
message	String	Сообщение об ошибке.	Нет

Запрос

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

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

curl -i -X POST 'https://api.iot.yandex.net/v1.0/scenarios/scenario-id-1/actions' \
-H 'Authorization: Bearer 123qwe456a...'

HTTP/1.1 200 OK

{
    "request_id": "667b3e0f-47a8-4136-9211-b4ff59062315",
    "status": "ok"
}

HTTP/1.1 404 Not Found

{
    "request_id": "667b3e0f-47a8-4136-9211-b4ff59062315",
    "status": "error",
    "message": "Сценарий не найден"
}