Python SDK
Для разработчиков

Python SDK

Для Python есть официальный SDK supporthub-sdk, который оборачивает REST API в удобный клиент: типизированные модели (Pydantic), автоматические повторы, поддержка синхронного и асинхронного режимов, встроенный long polling.

Установка

shell
pip install supporthub-sdk

Синхронный клиент

sync_example.py
from supporthub import Client

client = Client(api_key="sk_xxx")

# Создать тикет
ticket = client.tickets.create(
    subject="Не работает оплата",
    priority="high",
    contact={"email": "ivan@example.com", "name": "Иван"},
    message="Ошибка 500 при попытке оплатить тариф",
)

# История обращений контакта
history = client.tickets.history(ticket.contact_id, status="closed")
for t in history.items:
    print(t.subject, t.last_message_preview, t.rating)

# Загрузить файл и отправить сообщение с вложением
media = client.media.upload("screenshot.png")
client.messages.send(
    ticket_id=ticket.id,
    content="Вот скриншот",
    media_ids=[media.id],
)

# Поставить оценку
client.tickets.rate(ticket.id, 5, comment="Быстро решили!")

Асинхронный клиент

async_example.py
import asyncio
from supporthub import AsyncClient

async def main():
    async with AsyncClient(api_key="sk_xxx") as client:
        # Long polling в стиле Telegram getUpdates
        async for event in client.updates.stream(types=["message.created"]):
            msg = event.data
            if msg.sender_type == "contact":
                await client.messages.send(
                    ticket_id=msg.ticket_id,
                    content="Спасибо, скоро ответим!",
                )

asyncio.run(main())

Доступные ресурсы

Оба клиента (Client и AsyncClient) экспонируют один и тот же набор: tickets, messages, contacts, updates, webhooks, media, kb, workspace. Полный list методов, типизированные модели, кастомные исключения — в исходниках пакета на GitHub.

Документация SDK и исходники — в репозитории supporthub-sdk на GitHub (см. README.md). SDK следует той же версии API, что и это руководство (/api/v1).
Была ли страница полезной?