Запрос информации о пользователе (get user)

Умный дом Sber запрашивает у вендора идентификатор пользователя в системе вендора. Используется в следующем случае:

  1. В приложении Салют пользователь связывает свой Сбер ID со своим аккаунтом вендора.
  2. Умный дом отправляет запрос с токеном пользователя, в котором запрашивает идентификатор пользователя в системе вендора.
  3. Вендор возвращает идентификатор пользователя.

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

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

GET /v1/user

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

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

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

Поле Тип Обязательное? Описание
user_id string ✔︎ Идентификатор пользователя в системе вендора
{
    "user_id": string
}

При возникновении ошибки нужно возвращать объект типа common error:

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

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

Умный дом запрашивает у вендора идентификатор пользователя в системе вендора.

Запрос:

curl -i -X GET /v1/user 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"
}

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

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