Все эндпоинты находятся на api.freedomist.ru
Группы эндпоинтов:
default
: редирект на эту страницу и ручка для пинга сервиса /ping
;
search
: методы, реализующие функционал поиска;
static
: получение статичной информации о трекерах и их разделах (досках, boards);
utils
: вспомогательные методы для преобразования magnet-ссылок и т.п.
Комментарии к основным эндпоинтам:
/search
(swagger | redoc): поиск результатов по текстовому запросу (полностью аналогично поиску в боте). Доступны сортировки, выбор трекеров, фильтрация по размеру и иные модификации поведения поиска. Возвращает список раздач с указанием magnet_key
для запроса /magnet
.
/search_count
(swagger | redoc): возвращает точное количество
раздач из базы, подходящих под поисковый запрос.
/infohash
(swagger | redoc): поиск раздач по infohash
.
/magnet
(swagger | redoc): получение magnet-ссылки для скачивания раздачи.
/trackers
(swagger | redoc): получение списка трекеров.
/boards
(swagger | redoc): возвращает список board_id
для конкретного tracker
.
/board
(swagger | redoc): по указанному board_id
возвращает его текстовое описание (это "категория" раздачи).
К открытой версии API относятся все запросы без валидного token
в параметре или теле запроса. Для получения токенов, убирающих все нижеперечисленные ограничения, свяжитесь с нами одним из способов.
topic_id
будет иметь значение -1
;
magnet_key
для получения magnet-ссылки из результатов поиска составляет 15 минут;
status_code = 429
.