ym88659208ym87991671
Уведомление о разъединении аккаунтов (api_post_unlink) | Документация для разработчиков

Уведомление о разъединении аккаунтов (post unlink)

Обновлено 30 августа 2023

Вендор отправляет в умный дом запрос на разъединение аккаунтов пользователя: вендорского аккаунта и аккаунта Сбер ID. После этого пользователь не сможет управлять устройствами вендора через приложение Салют, приложении СберБанк Онлайн, на SberPortal, SberBox и других устройствах с ассистентом Салют.

Формат запроса

Вендор отправляет уведомление на эндпоинт умного дома Sber: https://partners.iot.sberdevices.ru/. Обратите внимание, что для обращения к облаку Sber на сервере вендора должны быть установлены российские сертификаты.

Заголовки см. в разделе Заголовки запросов.

POST /v1/unlink

Тело запроса:

ПолеТипОбязательное?Описание
user_idstring✔︎Идентификатор пользователя. Умный дом получает ID при связывании аккаунтов и затем хранит их (см. метод Запрос информации о пользователе (get user))
{
"user_id": string
}

Формат ответа

Умный дом отправляет ответ на эндпоинт вендора. Заголовки см. в разделе Заголовки запросов.

Успешный ответ:

HTTP/1.1 200 OK

При возникновении ошибки возвращается объект типа common error:

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

Пример запроса и ответа

Вендор запрашивает разъединение аккаунтов пользователя.

Запрос:

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

Успешный ответ:

HTTP/1.1 200 OK

Ответ с ошибкой:

{
"code": 400,
"message": "Invalid argument",
"details": []
}
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.