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

Host for all API requests:

https://dialogs.yango.com

You can only use the notification service API on behalf of the Yango user that created the skill in Yango Dialogs. To do this, get an OAuth token for Yango Dialogs. Specify the token in the Authorization header of each request to the notification service API:

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