AUDIORANOBE
Для разработчиков

документация API

Базовый адрес

https://back.audioranobe.com/api

Ответы — JSON в UTF-8; ошибки приходят как {"error": "текст"} с соответствующим HTTP-статусом.

Все эндпоинты ниже — публичные GET: авторизация не нужна, вызвать их можно с любого домена. Запросы отсюда уходят без авторизации, поэтому поля, зависящие от аккаунта, приходят пустыми.

Сервис

GET/home

Содержимое главной: объявления и подборки тайтлов (new_titles, popular, top_rated, recently_updated).

Попробовать
https://back.audioranobe.com/api/home

Тайтлы

GET/titles

Каталог.

Попробовать
qПоиск по названию тайтла и имени автора.
genreСлаг тега, например fantasy. Можно перечислить через запятую.
authorИмя автора целиком, без учёта регистра.
year_fromГод выпуска от, целое число.
year_toГод выпуска до, целое число.
release_statusongoing | completed | abandoned | frozen.
min_ratingМинимальная средняя оценка.
sortpopular (по умолчанию) | rating | new | updated | az.
pageНомер страницы, с 1. По умолчанию 1.
per_pageРазмер страницы. По умолчанию 24, максимум 100.
https://back.audioranobe.com/api/titles
GET/titles/{slug}

Карточка тайтла целиком: описание, теги, чтецы, тома с главами, похожие тайтлы.

Вместо слага можно передать числовой id — это поддерживается намеренно.

Попробовать
{slug}Часть адреса — slug или числовой id.
https://back.audioranobe.com/api/titles/1
GET/titles/random

Слаг случайного тайтла.

Попробовать
https://back.audioranobe.com/api/titles/random
GET/search/suggest

Быстрые подсказки для строки поиска: тайтлы, чтецы, авторы и подборки.

Попробовать
qЗапрос, минимум 2 символа. Короче — пустой результат.
https://back.audioranobe.com/api/search/suggest
GET/genres

Список тегов со счётчиком тайтлов.

Попробовать
qПоиск по названию.
pageНомер страницы, с 1. По умолчанию 1.
per_pageРазмер страницы. По умолчанию 24, максимум 100.
https://back.audioranobe.com/api/genres

Главы и файлы

GET/chapters/{id}

Данные для воспроизведения одной главы: audio_url, длительность, том, соседние главы.

404, пока глава не одобрена и её аудио не готово.

Попробовать
{id}Часть адреса — slug или числовой id.
https://back.audioranobe.com/api/chapters/1
GET/download/chapters/{id}

Сам аудиофайл (Opus) с заголовком Content-Disposition. Обычная ссылка для скачивания, авторизация не требуется.

Попробовать
{id}Часть адреса — slug или числовой id.
https://back.audioranobe.com/api/download/chapters/1

Чтецы и авторы

GET/narrators

Список чтецов.

Попробовать
qПоиск по имени.
pageНомер страницы, с 1. По умолчанию 1.
per_pageРазмер страницы. По умолчанию 24, максимум 100.
https://back.audioranobe.com/api/narrators
GET/narrators/{slug}

Страница чтеца: описание, ссылки, тайтлы.

Вместо слага принимается числовой id.

Попробовать
{slug}Часть адреса — slug или числовой id.
https://back.audioranobe.com/api/narrators/1
GET/narrators/{id}/posts

Посты чтеца.

Попробовать
{id}Часть адреса — slug или числовой id.
pageНомер страницы, с 1. По умолчанию 1.
per_pageРазмер страницы. По умолчанию 24, максимум 100.
https://back.audioranobe.com/api/narrators/1/posts
GET/posts/{id}

Один пост чтеца.

Попробовать
{id}Часть адреса — slug или числовой id.
https://back.audioranobe.com/api/posts/1
GET/authors

Список авторов.

Попробовать
qПоиск по имени.
pageНомер страницы, с 1. По умолчанию 1.
per_pageРазмер страницы. По умолчанию 24, максимум 100.
https://back.audioranobe.com/api/authors
GET/authors/{id}

Страница автора и его тайтлы.

Попробовать
{id}Часть адреса — slug или числовой id.
https://back.audioranobe.com/api/authors/1

Подборки, объявления, комментарии

GET/collections

Публичные подборки пользователей.

Попробовать
qПоиск по названию.
userИмя пользователя — вернёт только его публичные подборки.
sortnew (по умолчанию) | popular.
pageНомер страницы, с 1. По умолчанию 1.
per_pageРазмер страницы. По умолчанию 24, максимум 100.
https://back.audioranobe.com/api/collections
GET/collections/{id}

Одна подборка с её тайтлами.

Попробовать
{id}Часть адреса — slug или числовой id.
https://back.audioranobe.com/api/collections/1
GET/announcements

Опубликованные новости.

Попробовать
pageНомер страницы, с 1. По умолчанию 1.
per_pageРазмер страницы. По умолчанию 24, максимум 100.
https://back.audioranobe.com/api/announcements
GET/announcements/{slug}

Одна новость.

Попробовать
{slug}Часть адреса — slug или числовой id.
https://back.audioranobe.com/api/announcements/1
GET/comments

Комментарии к объекту, ответы вложены в родителя.

Попробовать
target_typeОбязательный: title | narrator | post | announcement.
target_idОбязательный: id объекта.
sortnew (по умолчанию) | old | top.
pageНомер страницы, с 1. По умолчанию 1.
per_pageРазмер страницы. По умолчанию 24, максимум 100.
https://back.audioranobe.com/api/comments?target_type=title&target_id=1

Профили

GET/users/{id}

Публичный профиль. Вместо id принимается имя пользователя.

Попробовать
{id}Часть адреса — slug или числовой id.
https://back.audioranobe.com/api/users/1
GET/users/{id}/library

Библиотека пользователя.

Попробовать
{id}Часть адреса — slug или числовой id.
pageНомер страницы, с 1. По умолчанию 1.
per_pageРазмер страницы. По умолчанию 24, максимум 100.
https://back.audioranobe.com/api/users/1/library
GET/users/{id}/favorites

Избранное пользователя.

Попробовать
{id}Часть адреса — slug или числовой id.
pageНомер страницы, с 1. По умолчанию 1.
per_pageРазмер страницы. По умолчанию 24, максимум 100.
https://back.audioranobe.com/api/users/1/favorites
GET/users/{id}/comments

Комментарии пользователя.

Попробовать
{id}Часть адреса — slug или числовой id.
pageНомер страницы, с 1. По умолчанию 1.
per_pageРазмер страницы. По умолчанию 24, максимум 100.
https://back.audioranobe.com/api/users/1/comments