Оповещение о разъединении аккаунтов
Оповещает о разъединении аккаунта пользователя на стороне провайдера и аккаунта пользователя на Яндексе (удаление связки аккаунтов, которое инициировал пользователь). Например, выход на всех аккаунтах.
Если пользователь разъединил аккаунты, пользовательский токен отзывается независимо от корректности полученного ответа на запрос.
Формат запроса платформы умного дома
POST https://functions.yandexcloud.net/<function_id>?integration=raw
Формат тела запроса
{
"headers": {
"request_id": String,
"authorization": String
},
"request_type": String,
"api_version": Float
}
Параметр |
Тип |
Описание |
Обязательный |
headers |
Object |
Объект с дополнительными полями запроса. |
Да |
request_type |
String |
Тип запроса. Допустимые значения:
|
Да |
api_version |
Float |
Версия протокола Умного дома. |
Да |
Объект headers
Параметр |
Тип |
Описание |
Обязательный |
request_id |
String |
Идентификатор запроса. Необходимо логировать на стороне провайдера для расследования инцидентов и проблем. |
Да |
authorization |
String |
Авторизационный токен пользователя. |
Да |
Формат ответа провайдера
Провайдер должен ответить на полученный от платформы умного дома запрос согласно формату.
HTTP/1.1 200 OK
{
"request_id": String
}
Параметр |
Тип |
Описание |
Обязательный |
request_id |
String |
Идентификатор запроса. |
Да |
Подробнее о том, как отдавать коды состояния, отличные от 200 OK
, читайте в документации.
HTTP/1.1 404 Not Found
Пример
ЗапросУспешный ответОтвет с ошибкой
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
Число с плавающей точкой с точностью до 6-9 десятичных знаков.
Список пар "ключ": значение
, разделенных запятой. Выделяется фигурными скобками {}
.
{
"name": "John",
"surname": "Smith"
}
Cтрока, выделяется кавычками, например "Hello world"
.