РКИ API / Документация о сервисе

В данном разделе приведен основной перечень запросов РКИ API.

Каталог книг

[POST] /books/list

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

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

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

Формат возвращаемых данных о публикации:

{
    "meta": {
        "success": true,
        "message": "",
        "total": 1495
    },
    "data": [
        {
            "book_id": 88766,
            "have_audio": 0,
            "is_audio_publication": 0,
            "title": "Физика в задачах. Электромагнетизм",
            "longtitle": "Учебное пособие для СПО",
            "pubhouses": "Профобразование, Ай Пи Ар Медиа",
            "authors": "Паршаков А.Н.",
            "year": "2020",
            "isbn": "978-5-4488-0727-5, 978-5-4497-0275-3",
            "description": "В учебном пособии на примере решения различных практических задач рассмотрены основные положения электромагнетизма. В издание включены задачи по следующим разделам: электростатика, электрический ток, магнетизм и различные нестационарные задачи электромагнетизма (явление электромагнитной индукции, движение заряженных частиц в электромагнитных полях). Подготовлено с учетом требований Федерального государственного образовательного стандарта среднего профессионального образования. Предназначено студентам всех специальностей и профессий среднего профессионального образования, изучающим дисциплину «Физика». Может быть полезно студентам инженерно-технических специальностей и профессий при изучении дисциплины «Электротехника и электроника».",
            "image": "images/profobrazovanie/small/978-5-4488-0727-5.jpg",
            "searchindex": 794
        },
        {
            "book_id": 81348,
            "have_audio": 0,
            "is_audio_publication": 0,
            "title": "Азбука тестирования. Практическое руководство для преподавателей РКИ",
            "longtitle": "",
            "pubhouses": "Златоуст",
            "authors": "Кирейцева А.Н.",
            "year": "2019",
            "isbn": "978-5-86547-637-5",
            "description": "В пособии приводятся теоретические сведения, которые необходимы начинающему тестологу, анализируются уже существующие тестовые батареи и даются конкретные рекомендации по разработке и применению учебных тестов. Изложение тестологических концепций в пособии сведено до минимума: автор делает упор на практические советы по созданию дискретных тестов (по отдельным видам речевой деятельности) и интегральных тестов, позволяющих определить степень сформированности целостного представления о русском языке в сознании иностранца. Пособие призвано помочь преподавателям освоить применение обучающих тестов в повседневной учебной практике. Это позволит им лучше подготовить студентов-иностранцев к сертификационному тестированию, по-новому взглянуть на возможности оценки знаний учащихся и добиться ее большей объективности. Адресовано всем специалистам в области РКИ, а также студентам старших курсов, аспирантам и преподавателям различных филологических специальностей, интересующимся проблемами языкового тестирования.",
            "image": "images/zlat.spb/small/978-5-86547-637-5.jpg",
            "searchindex": 914
        },
        {
            "book_id": 87784,
            "have_audio": 0,
            "is_audio_publication": 0,
            "title": "Алгебра и теория чисел",
            "longtitle": "Учебное пособие для СПО",
            "pubhouses": "Профобразование, Уральский федеральный университет",
            "authors": "Веретенников Б.М., Михалева М.М.",
            "year": "2019",
            "isbn": "978-5-4488-0405-2, 978-5-7996-2856-7",
            "description": "Учебное пособие включает в себя такие разделы, как элементарная теория чисел, теория сравнений, цепные и непрерывные дроби, p-адические числа. Предназначено для изучения дисциплин «Математика», «Математика: алгебра и начала анализа, геометрия» обучающимся по техническим специальностям и профессиям среднего профессионального образования.",
            "image": "images/defaults/pro_edu/small/2.jpg",
            "searchindex": 925
        }
    ]
}
			

В запрос Вы можете включать дополнительно параметры фильтрации каталога:

  • title - фильтрация по заглавию
  • pubhouse — по издательству
  • author — по авторам
  • year_left — ограничение года издания слева (>=)
  • year_right — ограничение года издания справа (<=)

[GET] /books/{id}/get

Данный запрос возвращает информацию об издании каталога. Дополнительно возвращается информация об оглавлении издания, если оно подготовлено:

{
    "meta": {
        "success": true,
        "message": ""
    },
    "data": {
        "book_id": 88766,
        "have_audio": 0,
        "is_audio_publication": 0,
        "title": "Физика в задачах. Электромагнетизм",
        "longtitle": "Учебное пособие для СПО",
        "pubhouses": "Профобразование, Ай Пи Ар Медиа",
        "authors": "Паршаков А.Н.",
        "year": "2020",
        "isbn": "978-5-4488-0727-5, 978-5-4497-0275-3",
        "description": "В учебном пособии на примере решения различных практических задач рассмотрены основные положения электромагнетизма. В издание включены задачи по следующим разделам: электростатика, электрический ток, магнетизм и различные нестационарные задачи электромагнетизма (явление электромагнитной индукции, движение заряженных частиц в электромагнитных полях). Подготовлено с учетом требований Федерального государственного образовательного стандарта среднего профессионального образования. Предназначено студентам всех специальностей и профессий среднего профессионального образования, изучающим дисциплину «Физика». Может быть полезно студентам инженерно-технических специальностей и профессий при изучении дисциплины «Электротехника и электроника».",
        "image": "images/profobrazovanie/small/978-5-4488-0727-5.jpg",
        "searchindex": 794,
        "addit": false,
        "accessible": true
    }
}		
			

[GET] /books/categories

Данный запрос возвращает информацию о категориях каталога.

{
    "meta": {
        "success": true,
        "message": ""
    },
    "data": [
        {
            "id": 13,
            "pagetitle": "Грамматика",
            "parent_title": "Учебная литература"
        },
        {
            "id": 21,
            "pagetitle": "Аудирование, чтение, говорение, письмо",
            "parent_title": "Учебная литература"
        },
        {
            "id": 22,
            "pagetitle": "Развитие речи",
            "parent_title": "Учебная литература"
        },
        {
            "id": 23,
            "pagetitle": "Чтение",
            "parent_title": "Учебная литература"
        },
        {
            "id": 24,
            "pagetitle": "Специализированные издания",
            "parent_title": "Учебная литература"
        },
        {
            "id": 25,
            "pagetitle": "Билингвальное, полилингвальное образование",
            "parent_title": "Учебная литература"
        },
        {
            "id": 164,
            "pagetitle": "Общеобразовательные предметы",
            "parent_title": "Учебная литература"
        },
        {
            "id": 241,
            "pagetitle": "Учебники, учебные пособия",
            "parent_title": "Учебная литература"
        },
        {
            "id": 319,
            "pagetitle": "Фонетика",
            "parent_title": "Учебная литература"
        },
        {
            "id": 27,
            "pagetitle": "Словари",
            "parent_title": "Вспомогательная литература"
        },
        {
            "id": 28,
            "pagetitle": "Тестирование",
            "parent_title": "Вспомогательная литература"
        },
        {
            "id": 29,
            "pagetitle": "Методики преподавания",
            "parent_title": "Вспомогательная литература"
        },
        {
            "id": 165,
            "pagetitle": "Нормативно-правовая база",
            "parent_title": "Вспомогательная литература"
        },
        {
            "id": 36,
            "pagetitle": "Литература для детей",
            "parent_title": "Художественная литература"
        },
        {
            "id": 35,
            "pagetitle": "Классика и современная литература",
            "parent_title": "Художественная литература"
        },
        {
            "id": 38,
            "pagetitle": "Страноведение",
            "parent_title": "Русская история и культура"
        },
        {
            "id": 39,
            "pagetitle": "Культура. Традиции",
            "parent_title": "Русская история и культура"
        },
        {
            "id": 40,
            "pagetitle": "История России",
            "parent_title": "Русская история и культура"
        },
        {
            "id": 41,
            "pagetitle": "Искусство России",
            "parent_title": "Русская история и культура"
        }
    ]
}
			

[GET] /books/levels

Данный запрос возвращает информацию уровнях владения языком.

{
    "meta": {
        "success": true,
        "message": ""
    },
    "data": [
        {
            "id": 1,
            "level": "Элементарный уровень (A1)"
        },
        {
            "id": 2,
            "level": "Базовый уровень (A2)"
        },
        {
            "id": 3,
            "level": "I сертификационный уровень (B1)"
        },
        {
            "id": 4,
            "level": "II сертификационный уровень (В2)"
        },
        {
            "id": 5,
            "level": "III сертификационный уровень (C1)"
        },
        {
            "id": 6,
            "level": "IV сертификационный уровень (C2)"
        }
    ]
}
			

[GET] /books/levels/{category_id}

Данный запрос возвращает информацию об уровнях владения языком в рамках указанной категории.

{
    "meta": {
        "success": true,
        "message": ""
    },
    "data": [
        {
            "id": 1,
            "level": "Элементарный уровень (A1)"
        },
        {
            "id": 2,
            "level": "Базовый уровень (A2)"
        },
        {
            "id": 3,
            "level": "I сертификационный уровень (B1)"
        },
        {
            "id": 4,
            "level": "II сертификационный уровень (В2)"
        },
        {
            "id": 5,
            "level": "III сертификационный уровень (C1)"
        },
        {
            "id": 6,
            "level": "IV сертификационный уровень (C2)"
        }
    ]
}
			

[GET] /books/pubhouses

Данный запрос возвращает информацию об издательствах каталога.

{
    "meta": {
        "success": true,
        "message": ""
    },
    "data": [
        {
            "pubhouses": "T8RUGRAM"
        },
        {
            "pubhouses": "«Русский язык». Курсы"
        },
        {
            "pubhouses": "Аделант"
        }
    ]
}
			

[GET] /books/authors

Данный запрос возвращает информацию об авторах каталога.

{
    "meta": {
        "success": true,
        "message": ""
    },
    "data": [
        {
            "authors": ""
        },
        {
            "authors": "Aesop"
        },
        {
            "authors": "Albert Payson Terhune"
        }
    ]
}
			

[GET] /books/years

Данный запрос возвращает информацию о годах выпуска книг.

{
    "meta": {
        "success": true,
        "message": ""
    },
    "data": [
        {
            "year": "2002"
        },
        {
            "year": "2004"
        },
        {
            "year": "2005"
        }
    ]
}