ym88659208ym87991671
Unlinking accounts (post unlink) | Documentation SmartMarket
Skip to main content

Unlinking accounts (post unlink)

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/. For the headers, see Query headers.

POST /v1/unlink

Query body:

FieldTypeMandatory?Description
user_idstring✔︎User ID. Sber Smart Home gets IDs during account linking and then stores them (see the Getting User Info (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": []
}