Donations

get_donations

Получить донаты за период через /timeline. Возвращает одну страницу результатов.

async def get_donations(
    self,
    since: Optional[datetime] = None,
    until: Optional[datetime] = None,
    limit: int = 50,
    page: int = 1,
) -> List[Donation]

Параметры

Параметр	Тип	По умолчанию	Описание
since	datetime	24 часа назад	Начало периода
until	datetime	Сейчас	Конец периода
limit	int	50	Количество на страницу
page	int	1	Номер страницы

Пример

from datetime import datetime, timedelta, timezone

async with CloudTipsClient(auth) as client:
    # За последние 24 часа (по умолчанию)
    donations = await client.get_donations()

    # За конкретный период
    yesterday = datetime.now(tz=timezone.utc) - timedelta(days=1)
    donations = await client.get_donations(since=yesterday)

    # Вторая страница
    page2 = await client.get_donations(page=2)

---

get_all_donations

Получить все донаты за период с автоматической пагинацией. Результат отсортирован по дате.

async def get_all_donations(
    self,
    since: Optional[datetime] = None,
    until: Optional[datetime] = None,
) -> List[Donation]

Параметры

Параметр	Тип	По умолчанию	Описание
since	datetime	24 часа назад	Начало периода
until	datetime	Сейчас	Конец периода

Пример

from datetime import datetime, timedelta, timezone

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

    # За неделю
    week_ago = datetime.now(tz=timezone.utc) - timedelta(days=7)
    weekly = await client.get_all_donations(since=week_ago)
    print(f"Всего за неделю: {len(weekly)} донатов")
    print(f"Сумма: {sum(d.amount for d in weekly)}₽")

---

Объект Donation

Смотри модель Donation.

print(donation)
# [2024-01-15 14:30] Алексей → 500₽ — "отличная работа!"

print(donation.name)    # Алексей
print(donation.amount)  # 500
print(donation.comment) # отличная работа!
print(donation.date)    # 2024-01-15 14:30:00+03:00