Что такое Telegram Stars API и какую задачу он решает?
Telegram Stars — основная платёжная единица для внутрибот-услуг, цифрового контента и подписок. Для реселлера, владельца бота или автоматизированного магазина выполнение каждого заказа вручную отнимает время и повышает риск ошибок.
Telegram Stars API объединяет этот процесс в один автоматический поток: приходит запрос клиента, система его проверяет, выполняет заказ и возвращает результат. Без участия оператора, в любое время суток.
- Полностью убирает ручную обработку
- Снижает человеческий фактор и риск ошибок
- Круглосуточный автоматический поток продаж
- Фиксируются история и статус каждого заказа
Как работает поток заказа?
Заказ Stars состоит из нескольких чётких шагов. Сначала получатель проверяется по username в Telegram, затем берётся актуальная цена от Fragment.com и проверяется, достаточно ли баланса проекта.
Если условия выполнены, оплата автоматически списывается со счёта проекта, и заказ завершается. Результат сразу возвращается в ответе API и записывается в статистику панели управления.
- getInfo — проверка пользователя по username
- stars/pricing — актуальная цена для выбранного количества
- stars/buy — автоматическое выполнение заказа
- wallet/balance — контроль баланса проекта
Основные эндпоинты
Интеграция работает в формате REST и JSON. К каждому запросу через заголовок X-API-Key добавляется секретный API-ключ проекта, а базовый адрес имеет вид /api/v1.
Для проверки пользователя используется /api/v1/getInfo, для получения цены — /api/v1/stars/pricing, для выполнения заказа — /api/v1/stars/buy. Для баланса и расчётов есть /api/v1/wallet/balance и /api/v1/wallet/calculate.
Все ответы имеют одинаковую структуру: ok (флаг успеха), message (пояснение), code (код статуса) и result (результат). Это делает интеграцию предсказуемой и упрощает обработку ошибок.
Как начать интеграцию?
Для начала зарегистрируйтесь и создайте проект, получите в нём API-ключ и настройте баланс проекта для выполнения заказов. После этого ваш бот или бэкенд сможет отправлять запросы к эндпоинтам.
Для каждого эндпоинта в документации /api полностью приведены примеры запросов, ответов и cURL, а также форматы ошибок. Это позволяет разработчику завершить интеграцию за короткое время.
- Создайте проект и дайте ему название
- Получите API-ключ и храните его в безопасности
- Настройте баланс проекта
- Отправьте первый тестовый заказ и проверьте ответ
Кому подходит?
Решение подходит реселлерам Telegram Stars, владельцам ботов, маркетплейсам и SMM-панелям, а также разработчикам, которые хотят автоматически обслуживать своих клиентов.
Если вы принимаете заказы через API, с Fragment-API.uz можно построить полностью автоматический поток продаж без отдельного оператора. Минимальный объём заказа Stars — 50 stars.
Частые вопросы
Нужно ли входить в аккаунт Telegram для работы с Telegram Stars API?
Нет. На стороне клиента вход не требуется. Проект работает через API-ключ, а заказ выполняется автоматически через серверную интеграцию.
Откуда берётся цена Stars?
Цена берётся из ответа Fragment.com, то есть из актуальной стоимости на момент заказа. Поэтому пользователю всегда показывается актуальная цена.
Какой минимальный объём Stars?
На платформе минимальный объём одного заказа Stars — 50 stars.
Как проходит оплата?
Оплата автоматически списывается с баланса проекта. Для выполнения заказа на балансе должно быть достаточно средств; иначе запрос не будет выполнен.
Где посмотреть статус заказа?
Статус сразу возвращается в ответе API (ok, message, code, result) и параллельно записывается в статистику панели проекта.
Можно ли открыть несколько проектов?
Да. У каждого проекта своё название, API-ключ и баланс, поэтому разных клиентов или направления удобно вести раздельно.