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

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

Метод Ресурс Описание
POST /api/v1/skills/{skill_id}/callback/discovery Уведомление об изменении параметров устройства
POST /api/v1/skills/{skill_id}/callback/state Уведомление об изменении состояния устройства
Метод Ресурс Описание
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' \