Все эндпоинты находятся на 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.