Руководство по интеграции

Python SDK там, где он удобен. Прямой REST — для остального.

Используйте актуальный Python-клиент или стандартный серверный fetch. Seed кошелька и данные сессии Fragment всегда остаются на вашем бэкенде.

Установка и варианты интеграции

Python SDK

Текущая версия: 2.1.6

Текущий официальный клиент — fragment-stars-api 2.1.6. По умолчанию он обращается к https://api.fragment-api.space.

Установка через pipbash

pip install fragment-stars-api

Открыть на PyPI

Прямой REST / TypeScript

Опубликованного TypeScript SDK нет. Для Node.js и серверного TypeScript используйте стандартный fetch к REST API.

https://api.fragment-api.space

Примеры кода

Покупка Stars через Python SDK

Основной Stars flow в версии 2.1.6 использует buy_stars и /api/v1/stars/buy.

python

from fragment_api import FragmentAPIClient

client = FragmentAPIClient()

result = client.buy_stars(
    username="@telegram_user",
    amount=100,
    seed="YOUR_BASE64_ENCODED_SEED",
    cookies="YOUR_BASE64_ENCODED_COOKIES",
    payment_method="ton",
    account_index=0,
)

print(result.success)

Чтение статуса, цен и ставок

Публичные методы клиента и эквивалентные REST запросы.

python

prices = client.get_prices()
rates = client.get_rates()
queue = client.get_queue_status()
eligibility = client.check_premium_eligibility("@telegram_user")
status = client.get_status("REQUEST_ID")

wallet = client.resolve_wallet(
    seed="YOUR_BASE64_ENCODED_SEED",
    wallet_address="YOUR_TON_WALLET_ADDRESS",
)
print(wallet.account_index)

premium = client.buy_premium(
    username="@telegram_user",
    duration=3,
    seed="YOUR_BASE64_ENCODED_SEED",
)

Публичные методы Python 2.1.6

buy_stars
buy_premium
get_rates
get_prices
get_queue_status
check_premium_eligibility
get_status
resolve_wallet

Начните с рабочего примера

Возьмите готовый магазин Telegram Stars и Premium, изучите исходный код Python или откройте полный REST-справочник.

Готовый магазин Исходный код Python SDK Справочник REST