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

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

Список пользователей организации

/users/get

Данный запрос возвращает список активных учетных записей пользователя.

  • limit — передайте параметр limit для корректировки количества элементов списка в ответе. Максимально можно указывать не более 100.
  • offset — смещение по списку (пропускает {offset} элементов)

Используйте параметр ответа total для формирования пагинации запросов.

Формат возвращаемых данных:

{
    "success": true,
    "message": "",
    "total": 19,
    "status": 200,
    "data": [
        {
            "id": 1565,
            "fullname": "Кузьмичев Николай Валерьевич",
            "email": "ctomatolor@gmail.com",
            "blocked": 0,
            "logincount": 21
        },...
			

/users/add (POST)

Запрос на добавление пользователя. Обязательно должны быть переданы следующие данные:

  • email — email-адрес пользователя, длина не более 255 символов
  • fullname — полное имя пользователя
  • specialty_id — идентификатор направления подготовки пользователя из структуры организации

Опционально:

  • password — пароль пользователя (не менее 6 символов, латинские буквы и цифры)

Формат ответа в случае успеха:

{
    "success": true,
    "message": "Пользователь успешно зарегистрирован.",
    "status": 200,
    "data": {
        "id": 43924,
        "fullname": "Иванов Петр Сергеевич",
        "email": "ctomatolor2222@elibs.ru"
    }
}	
			

Формат ответа в случае ошибки:

{
    "success": false,
    "message": "Пользователь с таким адресом электронной почты уже существует.",
    "status": 200,
    "data": null
}
			

/users/{user_id}/generateToken

Данный запрос создает токен авторизации для пользователя ВКР-ВУЗ для автологина на портале.

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