Для разработчиков
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).Была ли страница полезной?