ЭБС IPR BOOKS API / Документация о сервисе

В данном разделе приведен основной перечень запросов IPR BOOKS API.

Бесшовная интеграция

/2.0/security/generateToken/{$id}

Данный запрос создает уже существующему пользователю ЭБС уникальный одноразовый ключ, в ответе вы получите ссылку на активацию ключа и авторизации данного пользователя.

{
    "success": true,
    "message": "Одноразовый веб-токен успешно сгенерирован",
    "status": 200,
    "data": "http://www.iprbookshop.ru/api-auth?u=****&t=********************************    
}
			

Данный запрос принимает параметры, передаваемые ему в GET-массиве:

  • publication_id - если передано, проверяется существует ли данная публикация, если да, произойдет автопереход на страницу публикации

Формат ошибок:

{
    "success": false,
    "message": "Пользователь не найден в БД ЭБС",
    "status": 404,
    "data": null
}
			

/2.0/security/generateAutoAuthUrl

Данный запрос создает ссылку для прохождения автоматической регистрации/аутентификации пользователя. Если пользователь был создан ранее, то по данной ссылке произойдет его автовход в ЭБС, если пользователя нет в ЭБС, автоматически будет создана его учетная запись и произведен вход.

{
    "success": true,
    "message": "Ссылка успешно сгенериравана",
    "status": 200,
    "data": "http://www.iprbookshop.ru/auto-api-auth?&client_id=****&token=********************************&time=**********&email=**********&fullname=***********&user_type=[1-4]&publication_id=*****&open_method=******
}
			

Данный запрос принимает параметры, передаваемые ему в GET-массиве:

  • email — email пользователя, если он уже зарегистрирован, произойдет автоматическая авторизация данного пользователя
  • fullname - полное имя пользователя
  • user_type - тип пользователя:
      1 - студенты
      2 - аспиранты
      3 - преподаватели
      4 - нетипизированный
  • publication_id - если передано, проверяется существует ли данная публикация, если да, произойдет автопереход на страницу публикации
  • open_method - работает, если передан publication_id, может иметь только 1 значение «iframe», либо не существовать в принципе. Если передан open_method=iframe, проверит доступность издания, проверит возможность загрузки в iframe, если все проверки успешно пройдены, откроет ридер с загруженной публикацией

Формат ошибок:

{
    "success": false,
    "message": "Ссылка не может быть сгенерирована, проверьте правильность переданных параметров",
    "status": 404,
    "data": null
}