Notification of unlinked accounts

Notifies you that the user's provider account and Yandex account were unlinked (the link between them was deleted by the user). For example, if the user logged out from all accounts.

If the user has unlinked the accounts, the user token is revoked regardless of whether the request response is valid.

Smart home platform request format

POST https://functions.yandexcloud.net/<function_id>?integration=raw

Request body format

{
  "headers": {
    "request_id": String,
    "authorization": String
  },
  "request_type": String,
  "api_version": Float
}

Parameter	Type	Description	Required
headers	Object	Object with additional request fields.	Yes
request_type	String	Request type. Acceptable values: unlink: Notification that accounts were unlinked	Yes
api_version	Float	The protocol version of Yandex Smart Home.	Yes

headers object

Parameter	Type	Description	Required
request_id	String	Request ID. Should be logged on the provider's side for investigating incidents and problems.	Yes
authorization	String	User's authorization token.	Yes

Provider response format

The provider must use the correct format to respond to the request received from the smart home platform.

Response successful

Response with error

HTTP/1.1 200 OK

{
  "request_id": String
}

Parameter	Type	Description	Required
request_id	String	Request ID.	Yes

For more information about returning status codes other than 200 OK, see the documentation.

HTTP/1.1 404 Not Found

Global codes

Example

Request

Response successful

Response with error

curl -i POST https://functions.yandexcloud.net/<function_id>?integration=raw \
-H 'Content-Type: application/json' \
-d '{
      "headers": {
        "request_id": "1111-aaaa-2222-bbbb",
        "authorization": "Bearer 123qwe456a..."
      },
      "request_type": "unlink",
      "api_version": 1.0
}'

HTTP/1.1 200 OK

{
  "request_id": "1111-aaaa-2222-bbbb"
}

HTTP/1.1 500 Internal Server Error

List of "key": value pairs separated by commas. The list is enclosed in curly brackets {}.

{
  "name": "John",
  "surname": "Smith"
}

Was the article helpful?

Change device state

Information about user devices