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

Схему работы сервиса уведомлений см. в разделе С чего начать. Обязательные требования к отправке уведомлений — в разделе Требования к уведомлениям.

Метод

Ресурс

Описание

POST

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

Уведомление об изменении параметров устройства (/callback/discovery)

POST

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

Уведомление об изменении состояния устройства (/callback/state)

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

Уведомления принимаются, если навык был опубликован хотя бы один раз, включая приватную публикацию. На черновике навыка, который ни разу не публиковали, сервис уведомлений не работает — отлаживайте отправку уведомлений на опубликованном навыке.

Рекомендуемый порядок:

  1. Приватная публикация навыка.
  2. Проверка уведомлений на приватном навыке.
  3. Перевод навыка в публичный и модерация.

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

Важно

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

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

https://dialogs.yandex.net

Полученный токен необходимо указывать в каждом запросе к 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' \