Unlinking accounts notification (post unlink)

Last updated on December 23, 2022

The vendor sends a request to Sber Smart Home to unlink the user account in the vendor system and Sber ID. After that, the user will not be able to manage the vendor's devices through Sber Salut, SberPortal, SberBox, and other devices supported with Salut assistants.

Query format

The vendor sends a notification to Sber Smart Home endpoint: https://partners.iot.sberdevices.ru/. Please note that in order to access the Sber cloud, Russian certificates must be installed on vendor's server.

For the headers, see Query headers.

POST /v1/unlink

Query body:

Field	Type	Mandatory?	Description
user_id	string	✔︎	User ID. Sber Smart Home gets IDs during account linking and then stores them (see the Request user information (get user) method)

{
    "user_id": string
}

Response format

Sber Smart Home sends a response to the vendor's endpoint. For the headers, see Query headers.

Success response:

HTTP/1.1 200 OK

When an error occurs, an object of the Common error (common error) type should be returned:

{
    "code": integer,
    "message": string,
    "details": list<string>
}

Sample query and response

The vendor requests the user’s accounts unlinking.

Query:

curl -i -X POST /v1/unlink HTTP/1.1 \
-H Host: example.com \
-H Content-Type: application/json \
-H Authorization: Bearer qwerty-1234-... \
-H X-Request-Id: abcd-0000-ifgh-...

{
    "user_id": "AB12345"
}

Success response:

HTTP/1.1 200 OK

Error response:

{
    "code": 400,
    "message": "Invalid argument",
    "details": []
}