Skip to content

Client Overview

CloudTipsClient — основной класс для работы с CloudTips API.

Создание клиента

from cloudtips import CloudTipsAuth, CloudTipsClient

client = CloudTipsClient(auth)

Параметры конструктора

Параметр Тип По умолчанию Описание
auth CloudTipsAuth Объект аутентификации
base_url str https://api.cloudtips.ru/api Базовый URL API

Управление сессией

Рекомендуемый способ — контекстный менеджер

async with CloudTipsClient(auth) as client:
    donations = await client.get_all_donations()

Ручное управление

client = CloudTipsClient(auth)
await client.open()
try:
    donations = await client.get_all_donations()
finally:
    await client.close()

Методы сессии

Метод Описание
await client.open() Открыть aiohttp-сессию
await client.close() Закрыть aiohttp-сессию

Доступные методы

Донаты

Метод Описание
get_donations(...) Получить донаты за период (одна страница)
get_all_donations(...) Получить все донаты с автопагинацией
poll(...) Бесконечный поллинг новых донатов

Профиль

Метод Описание
get_me() Получить профиль текущего пользователя

Карты

Метод Описание
get_cards() Список привязанных карт
delete_card(card_token) Удалить карту

Выплаты и баланс

Метод Описание
get_accumulation_summary() Сводка накоплений и баланс
get_payout_fee_info() Информация о комиссиях
get_payout_method() Текущий метод выплат
set_payout_method(method) Установить метод выплат