مستندات کتابخانه rubka کلاس TvRubika

کتابخانه TvRubika یک کلاینت غیررسمی، مدرن و ناهمگام (asynchronous) برای تعامل با بخش تلویزیون (VOD) روبیکا در پایتون است.

شروع سریع و احراز هویت

برای استفاده از کتابخانه به توکن احراز هویت (auth) نیاز دارید که می‌توانید از نسخه وب روبیکا (m.rubika.ir) دریافت کنید. سپس کد زیر را اجرا نمایید:

import asyncio
from rubka import TvRubika

# auth را با توکن خود جایگزین کنید
AUTH_TOKEN = "your_auth_token_here"

async def main():
    async with TvRubika(AUTH_TOKEN) as bot:
        account_info = await bot.get_me()
        print(account_info)

asyncio.run(main())
        

فهرست توابع (API Index)

• مدیریت حساب
• get_me
• get_wish_list
• جستجو و دریافت محتوا
• search_video
• get_media_by_id
• get_list_items
• get_custom_menu_items
• get_Related
• عوامل و سریال‌ها
• get_cast_info
• get_cast_medias
• get_Season_Episodes
• تعامل با محتوا
• like_media
• un_like_media
• add_wish_media

مرجع کامل توابع (API Reference)

get_me

اطلاعات حساب کاربری شما را دریافت می‌کند.

user_data = await bot.get_me()
print(user_data)
        

get_wish_list

لیست فیلم‌ها و سریال‌های موجود در "لیست علاقه‌مندی‌ها" شما را برمی‌گرداند.

wishlist = await bot.get_wish_list()
print(wishlist)
        

search_video

برای فیلم یا سریال در کل پلتفرم جستجو می‌کند.

results = await bot.search_video(text="انتقام جویان")
print(results)
        

get_media_by_id

اطلاعات کامل یک فیلم یا سریال خاص را با استفاده از شناسه آن (media_id) دریافت می‌کند.

media_info = await bot.get_media_by_id(media_id="MEDIA_ID_HERE")
print(media_info)
        

get_list_items

محتوای یک لیست خاص (مانند "پرفروش‌ترین‌ها" یا "جدیدترین‌ها") را دریافت می‌کند.

new_movies = await bot.get_list_items(list_id="LIST_ID_HERE")
print(new_movies)
        

get_custom_menu_items

آیتم‌های منوی اصلی تلویزیون روبیکا (مانند دسته‌بندی‌ها) را دریافت می‌کند.

menu_items = await bot.get_custom_menu_items()
print(menu_items)
        

get_Related

لیست محتواهای مرتبط با یک فیلم یا سریال خاص را برمی‌گرداند.

related_content = await bot.get_Related(media_id="MEDIA_ID_HERE")
print(related_content)
        

get_cast_info

اطلاعات یک عامل (بازیگر، کارگردان و ...) را بر اساس شناسه او (cast_id) دریافت می‌کند.

cast_details = await bot.get_cast_info(cast_id="CAST_ID_HERE")
print(cast_details)
        

get_cast_medias

لیست فیلم‌ها و سریال‌های مرتبط با یک عامل را دریافت می‌کند.

actor_movies = await bot.get_cast_medias(cast_id="CAST_ID_HERE")
print(actor_movies)
        

get_Season_Episodes

لیست قسمت‌های یک فصل خاص از یک سریال را برمی‌گرداند.

episodes = await bot.get_Season_Episodes(season_id="SEASON_ID_HERE", series_id="SERIES_ID_HERE")
print(episodes)
        

like_media

یک فیلم یا سریال را لایک می‌کند.

response = await bot.like_media(media_id="MEDIA_ID_TO_LIKE")
print(response)
        

un_like_media

لایک یک فیلم یا سریال را برمی‌دارد (Dislike).

response = await bot.un_like_media(media_id="MEDIA_ID_TO_UNLIKE")
print(response)
        

add_wish_media

یک فیلم یا سریال را به لیست علاقه‌مندی‌ها اضافه می‌کند.

response = await bot.add_wish_media(media_id="MEDIA_ID_TO_ADD")
print(response)