ВОЙТИ | ПРИЛОЖЕНИЯ | ДОКУМЕНТАЦИЯ | ПОДДЕРЖКА

EN | RU | Графическая версия

API v1

Сервис LUWRAIN Books поддерживает доступ посредством функций RESTful API, который позволяет создавать различные пользовательские приложения, функционирующие без использования браузера. Клиентские библиотеки на основе нашего API, подготовленные для некоторых языков, вы можете найти на соответствующей странице.

В целях безопасности API нашего сервиса поддерживает обращения только по протоколу HTTPS. Запросы по-соответствующим адресам с использованием протокола HTTP всегда возвращают ответы-перенаправления. с подстановкой протокола HTTPS. API не создаёт пользовательских сессий на стороне сервера. Для авторизации пользователя при выполнениb запросов ожидается предоставление токена доступа (access token), который может быть получен при помощи запросов секции /v1/user/. В случае компрометации токен доступа может быть отозван в любой момент, при этом злоумышленник, получивший чужой токен доступа, всё равно не сможет лишить владельца его учётной записи (сменить пароль и пр.).

При работе с книгами соблюдается ряд соглашений о терминологии. Все книги, загруженные пользователем и находящиеся в обработке (даже если эта обработка выполняется сугубо в автоматическом режиме без участия пользователя), получают статус задачи (task). Задача — внутренняя рабочая единица для каждого пользователя. Информация о задачах и любые материалы, связанные с задачами, никогда не могут быть получены без предоставления токена доступа владельца задачи. Библиотека (lib) — множество книг в текстовом формате, содержащих всю необходимую разметку для создания полноценной аудиокниги. Репозиторий (repo) — множество готовых аудиокниг, созданных по запросам пользователей на основе книг в библиотеке или после успешного выполнения задачи. Публикация книги в библиотеке или в репозитории происходит только по явному указанию пользователя, что подразумевает принятие им всей ответственности за соблюдение авторских прав. При этом возможно помещение книги в библиотеку или репозиторий только для личных целей. В этом случае доступ к ней возможен только при предоставлении токена доступа владельца.

Разделы LUWRAIN Books API


© 2012–2021 Разработчики LUWRAIN
Проверить при помощи w3.org