Реализуемые методы

Поиск по произвольному запросу

HTTP request
GET http://yourhost.com/bsapi/apiVersion/search

Возвращает отсортированный по релевантности список документов подходящих под критерии поискового запроса. При отсутствии результатов поиска возвращается пустое сообщение.

Параметры
query string [required]
Поисковый запрос, максимальная длинна 400 символов
inFulltext boolean
Указывает на поиск в полном тексте документа, если такая возможность поддерживается. Значение по умолчанию false
limit integer
Максимальное количество выдаваемых результатов.
Значение по умолчанию 100
Минимальное значение 1
Максимальное значение 100

Параметризированный поиск

HTTP request
GET http://yourhost.com/bsapi/apiVersion/advsearch

Возвращает список документов подходящих под критерии поискового запроса. В данном случае порядок сортировки может быть произвольным и определяется источником. При запросе один из параметров всегда является обязательным.

Значения типа datetime должны быть предствалены в формате YYYY-MM-DDThh:mm:ssZ стандарта ISO 8601. Если время или точная дата не извесна, то используется не полная форма, например для книги опубликованной в 2011 году следует использовать формат YYYY

Параметры
query string
Поисковый запрос, максимальная длинна 400 символов
title string
Поисковый запрос, максимальная длинна 400 символов
authors string
Перечень авторов
isbn string
Номер ISBN/ISSN
publishedFrom datetime
Дата с которой опубликован документ
publishedTo datetime
Дата до которой опубликован документ
publisher string
Издатель
keywords string
Ключевые слова
limit integer
Максимальное количество выдаваемых результатов.
Значение по умолчанию 100
Минимальное значение 1
Максимальное значение 100

Возвращаемые данные

Разработчики ЭБС в праве добавлять произвольные параметры

Свойства
title string [required]
Название/заглавие документа
url string [required]
Ссылка на документ сайта-источник
type string [required]
Тип документа. Возможены следующие типы документов:
  • ebook - цифровая версия книги [default]
  • journal - периодическое издание
  • dissertation - диссертация
  • synopsis - автореферат
  • hardcopy - печатное издание
  • media - аудиокнига или видеозапись
  • other - прочие ресурсы
thumb string
Ссылка на миниатюру обложки документа
annotation string
Аннотация или краткое описание
author string
Список авторов документа
pageCount interger
Количество страниц в документе
publisher string
Издатель
published datetime
Дата публикации документа
classification.isbn string
ISBN документа
classification.issn string
ISSN документа
classification.bbk string
Код ББК
classification.udk string
Код УДК
classification.okso string
Код ОКСО
classification.oksoDesc string
Наименования кода ОКСО
classification.grnti string
Код ГРНТИ
classification.grntiDesc string
Наименование кода ГРНТИ
classification.vak string
Код ВАК
classification.vakDesc string
Наименование кода ВАК
classification.keywords string
Ключевые слова
classification.genre string
Жанр/рубрика
classification.series string
Серия
classification.subject string
Дисциплина (научная), отрасль знаний
snippets list
Массив отрывков текста, в которых найдено совпадение
related[ ].url string
Ссылка на документ сайта-источника, связанный с описываемым (например, ссылка на второй том двухтомника)
related[ ].name string
Описание ссылки на связанный документ
fulltext string
Исходный текст документ
fulltextLink string
Ссылка на исходный документ
titleEN string
Название/заглавие документа на английском языке
journal string
Название периодического издания
bibliolink string
Библиографическая ссылка
duration string
Продолжительность. Указывается для типа media в формате стандарта ISO 8601 PTnHnMnS если продолжительность больше часа и в формате PTnMnS если меньше.
  • Например:
  • PT4H38M56S - 4 часа 38 минут 56 секунд
  • PT23M42S - 23 минуты 42 секунды
HTTP response
                
[
    {
        "title": string,
        "url": string,
        "type": string,
        "thumb": string,
        "annotation": string,
        "authors": string,
        "pageCount": integer,
        "publisher": string,
        "published": datetime,   
        "classification":{
            "isbn": string,
            "issn": string,
            "bbk": string,
            "udk": string
            "okso": string,
            "oksoDesc": string,
            "grnti": string,
            "grntiDesc": string,
            "vak": string,
            "vakDesc": string,
            "keywords": string,
            "genre": string,
            "series": string,
            "subject": string
        },
        "snippets": list,
        "related": [{
            "url": string,
            "name": string
        }],
        "fulltext": string,
        "fulltextLink": string,
        "titleEN": string,
        "journal": string,
        "bibliolink": string,
        "duration": string
    }
]
Пример
                
[
    {
        "type": "ebook",
        "url": "http://www.bibliorossica.com/book/7309" ,
        "thumb": "http://www.bibliorossica.com/images/web/book/7572a3f349183621fc8e30a0c6d5d35e416.png" ,
        "annotation": "Собрание отрывков из произведений Иммануила Канта на русском языке подготовлено проф. В. Н. Брюшинкиным и содержит высказывания Канта. Книга адресована широкому кругу читателей." ,
        "authors": "Кант И.",
        "pageCount": 364,
        "title": "Изречения",
        "publisher": "Балтийский федеральный университет им. Иммануила Канта",
        "published": "2012-04-23T18:25:43Z",
        "classification":{
            "isbn": "978-5-9971-0077-3"
        },
    }
]