Внешние поставщики#

Список внешних поставщиков#

Метод

GET https://login.company.com/blitz/api/v3/users/{subjectId}/fa

Получение списка привязок учетных записей внешних поставщиков идентификации к учетной записи пользователя.

Необходимые разрешения: blitz_api_ufa или blitz_api_sys_ufa.

Возвращает

Тип и имя привязки (fpType и fpName) и идентификатор привязки (sid).

Пример

GET /blitz/api/v3/users/d2580c98‑e584‑4aad‑a591‑97a8cf45cd2a/fa HTTP/1.1
Authorization: Bearer m9tuVBNUnizkuwFnq95IXQm1XTplXLUFD1O5TUmGij4
Cache-Control: no-cache

[
    {
        "sid": "1000347601",
        "fpType": "esia",
        "fpName": "esia_1"
    },
    {
        "sid": "1234",
        "fpType": "tcs",
        "fpName": "tcs_1"
    }
]

Привязка поставщика по идентификатору#

Метод

POST https://login.company.com/blitz/api/v3/users/{subjectId}/fa/{fpType}/{fpName}/{sid}

Привязка учетной записи внешнего поставщика идентификации к учетной записи пользователя, если вход через внешний поставщик идентификации произведен ранее иными средствами и известен идентификатор (sid) учетной записи во внешнем поставщике идентификации.

Необходимые разрешения: blitz_api_ufa_chg или blitz_api_sys_ufa_chg.

URL-параметры

guid пользователя (subjectId), тип внешнего поставщика (fpType), имя внешнего поставщика (fpName) и идентификатор учетной записи во внешнем поставщике (sid).

Возвращает

В случае успешного вызова 204 No Content.

Пример

Запрос#
POST /blitz/api/v3/users/d2580c98‑e584‑4aad‑a591‑97a8cf45cd2a/fa/tcs/tcs_1/1234 HTTP/1.1
Authorization: Bearer m9tuVBNUnizkuwFnq95IXQm1XTplXLUFD1O5TUmGij4

Привязка поставщика#

Привязка к учетной записи внешнего поставщика при неизвестном идентификатору учетной записи во внешнем поставщике осуществляется в два этапа:

  • Запрос инструкции привязки.

  • Выполнение привязки пользователем в браузере.

Метод

POST https://login.company.com/blitz/api/v2/users/current/fa/bind

Запрос инструкции привязки.

Тело запроса

  • fp – идентификатор поставщика, связь с профилем которого должна быть установлена;

  • callback – адрес, на который должен быть возвращен пользователь после успешной привязки аккаунта соцсети;

  • isPopup – требуется ли открытие страницы поставщика идентификации в popup-окне (опционально).

Возвращает

Параметр redirectTo с ссылкой, на которую необходимо направить пользователя в браузере для выполнения второго этапа и создания привязки учетной записи пользователя к внешнему поставщику идентификации.

Пример

POST /blitz/api/v2/users/current/fa/bind HTTP/1.1
Authorization: Basic ZG5ldm5pay10ZXN0Lm1vcy5ydTphUU56S0JuY2VBQVQwelg
Content-Type: application/json

{
    "fp": "vk:vk_1",
    "callback": "https://app.company.com/callback"
}

{
    "redirectTo": "https://oauth.vk.com/authorize?state=5c415063-a153-424c-af9c-023a6bbf1892&scope=email&redirect_uri=https%3A%2F%2Flogin.company.com%2Fblitz%2Fapi%2Fusers%2Fcurrent%2Ffps%2Fbind%2Fcb%2Fvk%2Fvk_1&client_id=5566286&v=5.52&response_type=code"
}

Удаление привязки поставщика#

Метод

DELETE https://login.company.com/blitz/api/v2/users/{subjectId}/fa/{fpType}/{fpName}/{sid}

Удаление привязки внешнего поставщика к пользователю.

URL-параметры

guid пользователя (subjectId), тип внешнего поставщика (fpType), имя внешнего поставщика (fpName) и идентификатор учетной записи во внешнем поставщике (sid).

Пример

Заголовок#
DELETE /blitz/api/v3/users/d2580c98‑e584‑4aad‑a591‑97a8cf45cd2a/fa/tcs/tcs_1/1234 HTTP/1.1
Authorization: Bearer m9tuVBNUnizkuwFnq95IXQm1XTplXLUFD1O5TUmGij4