Протокол работы сервиса уведомлений

Схему работы сервиса уведомлений см. в разделе С чего начать.

Метод

Ресурс

Описание

POST

/api/v1/skills/{skill_id}/callback/discovery

Уведомление об изменении параметров устройства

POST

/api/v1/skills/{skill_id}/callback/state

Уведомление об изменении состояния устройства

Примечание

Сервис уведомлений доступен только для опубликованных навыков. Если вы только разрабатываете навык, то можно сделать его приватным на время тестирования и не открывать для внешних пользователей.

Доступ и авторизация

Хост для всех запросов к API:

https://dialogs.yandex.net

Использовать API сервиса уведомлений можно только от имени пользователя Яндекса, который создал навык в Диалогах. Для этого нужно получить OAuth-токен для Диалогов. Полученный токен необходимо указывать в каждом запросе к API сервиса уведомлений, в заголовке Authorization:

curl -i -X POST 'https://dialogs.yandex.net/api/v1/skills/user-test-skill/callback/state' \
-H 'Authorization: OAuth OUR_OAUTH_TOKEN' \
-H 'Content-Type: application/json' \