Единая авторизация позволяет объединить аккаунты клиента на нескольких сайтах.

Подробнее о механизме авторизации можно узнать здесь.

Описание методов:

  • /auth/authorize/ - загрузка страницы авторизации в SailPlay
  • /auth/get-auth-hash/ - привязка аккаунтов
  • /auth/oauth-sdk/<partner_id>/ - загрузка SDK единой авторизации

/auth/authorize/ - загрузка страницы авторизации в SailPlay

Назначение метода

Метод используется JS SDK попапа SailPlay при исопльовании единой авторизации для открытия страница авторизации.

Параметры запроса

Параметр обязательный? Имя параметра Описание параметра
да redirect_url  URL, на котороый будет переправлен клиент после авторизации в едином аккаунте SailPlay. URL должениметь в начале http://www.
да partner_id  Идентифиикатор партнера
да store_department_id  Идентификатор отдела.

Ответ сервера

Если клиент не авторизован в SailPlay, метод вернет страницу авторизации в едином аккаунте SailPlay.

Если клиент авторизован, метод перенаправит клиента на redirect_url и добавит в url значения origin_user_id и code

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

http://sailplay.ru/auth/authorize/?store_department_id=422&partner_id=354&redirect_url=http://www.ya.ru

Пример url перенаправления

http://www.ya.ru/?origin_user_id=c9d4f1b4a65c42ecbeafd33e33cbadab&code=0d873be6e369a2eac3e269f067d72a61dc622872

/auth/get-auth-hash/ - привязка аккаунтов

Назначение метода

Это метод сервер-серверного взаимодействия при единой авторизации.

Метод используется для связывания единого аккаунта SailPlay и аккаунта в вашей системе.

Параметры запроса

Обращение к этому методу происходит POST запросом.

Параметр обязательный? Имя параметра Описание параметра
да origin_user_id  Основной идентификатор клиента. Генерируется на стороне SailPlay и передается в вашу систему параметром в redirect_url.
да code  Дополнительный идентификатор клиента. Генерируется на стороне SailPlay и передается в вашу систему параметром в redirect_url.
да redirect_url  URL, на который был отправлен клиент.
да secret  Секретный ключ сервер-серверного взаимодействия. 
да store_department_id  Идентификатор отдела.

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

http://sailplay.ru/auth/get-auth-hash/

POST - параметры:

origin_user_id: origin354
code: c53fb837bf529c2b66adc019e96b478a75952a6c
redirect_url: http://www.ya.ru
secret: 245335da93b4799dca2b3ddda94a80
store_department_id: 422

Пример ответа

{"auth_hash": "3c89b4ecc169f400b1c95a06cd81be469855936b", "origin_user_id": "origin151"}

/auth/oauth-sdk/<partner_id>/ - загрузка SDK единой авторизации

Назначение метода

Метод возвращает JS SDK, который можно использовать для управления popup'ом единой автризации.

Указание partner_id  в URL запроса обязательно.