Python SDK: Быстрый старт
Прозрачность финансовых данных для современного бизнеса. Подключите аналитику Логкит к вашему приложению за 5 минут с помощью нативной библиотеки.
pip install logkit-python
# Установка версии 2.4.1
pip install logkit-python==2.4.1
1. Установка
Библиотека поддерживает Python 3.8+. Для установки используйте стандартный менеджер пакетов. Мы публикуем пакеты на PyPI и поддерживаем зеркало для корпоративных репозиториев.
Требуемые зависимости (urllib3, requests, pydantic) устанавливаются автоматически.
2. Инициализация клиента
Для начала работы создайте экземпляр клиента, указав ваш API-ключ. Ключи можно сгенерировать в разделе "Настройки" личного кабинета Логкит.
- Автоматическая обработка токенов
- Таймауты по умолчанию (30с)
from logkit import LogkitClient
# Инициализация
client = LogkitClient(
api_key='sk_live_8f92a3b1c4d5',
env='production'
)
# Проверка соединения
status = client.ping()
print(status) # {'status': 'ok', 'latency_ms': 24}
# Подписка на события
def on_transaction(event):
if event.type == 'payment.failed':
send_alert(event.data)
client.subscribe(
pattern='payment.*',
callback=on_transaction
)
3. Обработка событий
SDK предоставляет удобный механизм подписки на потоки логов. Вы можете фильтровать события по паттернам прямо в клиенте, не перегружая сеть лишними данными.
Доступные типы событий: transaction.created, transaction.failed, audit.login, system.alert.
4. Тестирование в Sandbox
Не рискуйте данными в продакшене. Используйте Sandbox-окружение для отладки интеграции. В песочнице генерируются синтетические транзакции, имитирующие реальные сценарии.
Ключ для песочницы:
sk_test_51MzX...9a2b
Для переключения на тестовый режим достаточно изменить параметр env='sandbox' при инициализации клиента.