Rodina Forum API Async

Асинхронная Python библиотека для взаимодействия с форумом Rodina RP (forum.rodina-rp.com) без необходимости получения API ключа.

Эта библиотека предоставляет современный, асинхронный интерфейс для работы с форумом Rodina RP. Это изменённая под Родину версия оригинальной библиотеки Arizona-Forum-API-Async, построенная с использованием aiohttp.

Ключевые особенности

• Полностью асинхронная: Построена с использованием asyncio и aiohttp.
• Не требует API ключа: Взаимодействует с форумом, имитируя запросы браузера, что избавляет от необходимости получать официальные ключи XenForo API.
• Обширная функциональность: Поддерживает около 38 методов.
• Объектно-ориентированные модели: Представляет сущности форума, такие как Member, Thread, Post, Category, в виде Python объектов с соответствующими методами.
• Простота использования: Предоставляет чистую и интуитивно понятную структуру API.

Установка

Установите библиотеку напрямую из PyPI:

pip install rodina-forum-api-async

Аутентификация и настройка

Поскольку эта библиотека имитирует действия залогиненного пользователя, вам потребуются две вещи из вашей браузерной сессии на forum.rodina-rp.com:

1. User Agent: Строка User Agent вашего браузера.
2. Cookies: Cookies вашей сессии на форуме.

Как их получить:

1. Войдите в свой форумный аккаунт на forum.rodina-rp.com.
2. Установите расширение "Cookie Editor", после чего с его помощью получите следующие значения:

• xf_session
• xf_tfa_trust
• xf_user

3. Узнайте свой User Agent браузера или используйте любые другие из интернета.

Документация и примеры

• Папка с примерами: Практические примеры, демонстрирующие различные возможности библиотеки.

Лицензия

Этот проект лицензирован под MIT License.