skymanager 1.0.1

Asynchronous API of the SkyManager service

SkyManagerAPI

Использование

With skymanagerapi you can use SkyManagerAPI together with Telegram
Documentation: https://skymanager.top/redoc

Установка

pip install skymanager 

Требования

• Python 3.7+
• aiohttp

Возможности

• Asynchronous
• Exception handling

Пример обязательной подписки, показов методом /check

from skymanagerapi import SkyManager

from aiogram import types


skym = SkyManager(skym_token) # skym_token api-ключ сервиса SkyManager

async def message_handler(message: types.Message):
    # Применяйте везде, где требуется проверка
    if not await skym.check(
            user_id=message.from_user.id,
            language_code=message.from_user.language_code,
            is_premium=message.from_user.is_premium): 
        return

async def callback_handler(call: types.CallbackQuery):
    # Применяйте везде, где требуется проверка
    if not await skym.check(
            user_id=call.from_user.id,
            language_code=call.from_user.language_code,
            is_premium=call.from_user.is_premium):
        return

Использование пользовательского сообщения

# Опционально, для метода check. Можно настроить также в @SkyManagerBot
message_custom = {
    "text": "Чтобы пользоваться чат-ботом, сначала выполните задания",
    "row_width": 2,                         # кнопок в одной в строке
    "buttons": [                            # [0] - bot, [1] - channel, [2] - url, [3] - boost
        {"title": "Запустить бота"},     # bot
        {"title": "Подписаться"},        # channel
        {"title": "Открыть"},            # external / url
    ]
}
# await skym.check(user_id, language_code=language_code, message=message_custom)

Пример интеграции без токена бота методами /get_tasks, /check_tasks

# Получение задач для пользователя /get_tasks
@dp.message(Command(commands=["start"]))
async def message_handler(message: types.Message):
    data = await skym.get_tasks(
        user_id=message.from_user.id,
        language_code=message.from_user.language_code,  # used only for new pinning
        is_premium=message.from_user.is_premium,
        limit=5) # количество слотов
    if data.get("result"):  
        # ВАЖНО! Необходимо добавить в код бота функцию отправки сообщения op_message(). Пример ниже.
        await op_message(bot, message.chat.id, data["result"], data["bundle_id"])
        return

...

# Получение статуса выполнения задач
@dp.callback_query(lambda c: c.data and c.data.startswith("sky_fp:"))
async def check_subscription(call: types.CallbackQuery):
    bundle_id = call.data.split(":", 1)[1]
    done = await skym.check_tasks(call.from_user.id, bundle_id)

    if done:
        await call.message.delete()
        await call.message.answer("Подписка подтверждена ✅")
    else:
        await call.answer("Вы ещё не подписались.", show_alert=True)


# Пример функции op_message().
async def op_message(bot, chat_id: int, tasks: list[dict], bundle_id: str, template: dict | None = None) -> None:
    if not tasks:
        return
    tpl        = template or {}
    text       = tpl.get("text", "👋 Для продолжения подпишитесь и нажмите «✅ Проверить».")
    row_width  = int(tpl.get("row_width", 2)) or 2

    t_bot      = tpl.get("button_bot",     "Запустить")
    t_channel  = tpl.get("button_channel", "Подписаться")
    t_url      = tpl.get("button_url",     "Перейти")
    t_boost    = tpl.get("button_boost",   "Голосовать")
    t_confirm  = tpl.get("button_fp",      "✅ Проверить")

    title_map = {"bot": t_bot, "channel": t_channel, "external": t_url, "boost": t_boost}

    rows, row = [], []
    for idx, t in enumerate(tasks, start=1):
        rtype = t.get("rtype", "external")
        row.append(
            types.InlineKeyboardButton(
                text=f"{idx} {title_map.get(rtype, t_url)}",
                url=t["url"],
            )
        )
        if len(row) == row_width:
            rows.append(row); row = []
    if row: rows.append(row)

    # bundle_id упаковывается в callback_data
    rows.append([
        types.InlineKeyboardButton(
            text=t_confirm,
            callback_data=f"sky_fp:{bundle_id}"
        )
    ])
    kb = types.InlineKeyboardMarkup(inline_keyboard=rows)
    await bot.send_message(chat_id, text, reply_markup=kb, parse_mode="HTML")

Developed by Mits (c) 2024-2025