Skip to content

CloudTips API

CloudTips

PyPI Downloads License Python 3.9+ Docs

Неофициальная асинхронная Python-библиотека для CloudTips — получение донатов, поллинг новых поступлений и автоматическое обновление токенов.

Установка

pip install cloudtips

Возможности

  • Получение донатов — за произвольный период с автопагинацией
  • Поллинг — три режима: async-генератор, async-колбэк, фоновая задача
  • Авто-рефреш токенов — токен обновляется за 2 минуты до истечения
  • Профиль — данные пользователя, метод выплат, лимиты
  • Карты — просмотр привязанных карт, удаление
  • Баланс и комиссии — сводка накоплений, информация о выводе
  • Полная типизация — dataclass-модели для всех ответов API

Быстрый старт

import asyncio
import json
from cloudtips import CloudTipsAuth, CloudTipsClient, TokenData

with open("donate.json") as f:
    config = json.load(f)

async def on_token_refresh(token_data: TokenData):
    config["cloudtips_token"] = token_data.access_token
    config["cloudtips_refresh_token"] = token_data.refresh_token
    config["cloudtips_expires_at"] = token_data.expires_at
    with open("donate.json", "w") as f:
        json.dump(config, f, ensure_ascii=False, indent=2)

auth = CloudTipsAuth(
    token=config["cloudtips_token"],
    refresh_token=config["cloudtips_refresh_token"],
    expires_at=config["cloudtips_expires_at"],
    on_token_refresh=on_token_refresh,
)

async def main():
    async with CloudTipsClient(auth) as client:
        donations = await client.get_all_donations()
        for d in donations:
            print(d)
        # [2024-01-15 14:30] Алексей → 100₽ — "спасибо за контент"

asyncio.run(main())

Требования

Лицензия

MIT © 2026 IRRatium