Оповещение о разъединении аккаунтов

Оповещает о разъединении аккаунта пользователя на стороне провайдера и аккаунта пользователя на Яндексе (удаление связки аккаунтов, которое инициировал пользователь). Например, выход на всех аккаунтах.

Если пользователь разъединил аккаунты, пользовательский токен отзывается независимо от корректности полученного ответа на запрос.

Формат запроса платформы умного дома

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

Тип запроса. Допустимые значения:

  • unlink — оповещение о разъединении аккаунтов.

Да

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