Notification service operating protocol

You can find the workflow chart for the notification service in Getting started.

Method	Resource	Description
POST	`/api/v1/skills/{skill_id}/callback/discovery`	Notification about change of parameters of a device
POST	`/api/v1/skills/{skill_id}/callback/state`	Notification about device state change

Note

The notification service is available only for published skills. If your skill is still under development, you can make it private for the testing period so that external users can't access it.

Access and authorization

Warning

You can only use the notification service API on behalf of the Yandex user that created the skill in Yandex Dialogs. To do this, get an OAuth token for Yandex Dialogs.

Host for all API requests:

https://dialogs.yandex.net

Specify the token in the Authorization header of each request to the notification service API:

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' \

Was the article helpful?

Response codes

Notification about device state change